HTTP Requests

• Request 엑세스 하기
  • 기본적인 Request 정보
  • PSR-7 Requests
• 입력값 조회하기
  • 이전 입력값 확인하기
  • 쿠키
  • 파일처리

Request 엑세스 하기

의존성 주입을 통해서 현재 HTTP request의 인스턴스를 획득하기 위해서는 컨트롤러 생성자나 메소드에서 Illuminate\Http\Request 클래스를 타입힌트해야 합니다. 현재 request의 인스턴스는 서비스 컨테이너에 의해서 자동으로 주입될 것입니다.

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * Store a new user.
     *
     * @param  Request  $request
     * @return Response
     */
    public function store(Request $request)
    {
        $name = $request->input('name');

        //
    }
}

만약 컨트롤러 메소드에서 라우터 파라미터로 부터 값을 받아야 한다면 의존성을 지정한 뒤에 라우트 인자를 나열하면 됩니다. 예를 들어 다음과 같이 라우트가 정의되어 있을 수 있습니다:

Route::put('user/{id}', 'UserController@update');

다음과 같이 컨트롤러 메소드를 정의하면 Illuminate\Http\Request를 타입힌트하여 라우트 파라미터 id에 접근할 수 있습니다:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * Update the specified user.
     *
     * @param  Request  $request
     * @param  string  $id
     * @return Response
     */
    public function update(Request $request, $id)
    {
        //
    }
}

기본적인 Request 정보

Illuminate\Http\Request 인스턴스는 애플리케이션의 HTTP request를 검사할 수 있는 다양한 메소드를 제공하며 Symfony\Component\HttpFoundation\Request 클래스를 상속 받고 있습니다. 다음은 이 클래스에 사용할 수 있는 몇몇 유용한 메소드입니다.

Request URI 조회하기

path 메소드는 request의 URI를 반환합니다. 따라서 들어오는 request가 http://domain.com/foo/bar를 대상으로 한다면 path 메소드는 foo/bar를 반환합니다:

$uri = $request->path();

is 메소드는 들어오는 request가 특정 패턴에 상응한다는 것을 확인할 수 있게 해줍니다. 이 메소드를 활용할 때 * 기호를 와일드카드로 쓸 수 있습니다:

if ($request->is('admin/*')) {
    //
}

경로 정보뿐만 아니라 전체 URL를 가져오려면 request 인스턴스에 url 메소드나 fullUrl 메소드를 사용하면 됩니다:

// Without Query String...
$url = $request->url();

// With Query String...
$url = $request->fullUrl();

또한 전체 URL과 쿼리파라미터 가져올 수도 있습니다. 예를 들어 다음의 http://domain.com/foo에 대한 요청의 경우 메소드 결과는 http://domain.com/foo?bar=baz를 반환합니다:

$url = $request->fullUrlWithQuery(['bar' => 'baz']);

Request HTTP 메소드 조회하기

method 메소드는 request에 대해 HTTP 메소드를 반환합니다. HTTP 메소드가 특정 문자열에 대응하는 것을 확인하기 위해 isMethod 메소드 또한 사용할 수 있습니다:

$method = $request->method();

if ($request->isMethod('post')) {
    //
}

PSR-7 Requests

PSR-7 표준은 요청과 응답을 포함한 HTTP 메세지들에 대한 인터페이스를 지정합니다. PSR-7 요청의 인스턴스를 갖기 위해서는 우선 몇 개의 라이브러리를 설치해야 합니다. 라라벨은 Symfony HTTP Message Bridge 컴포넌트를 사용하여 라라벨의 전형적인 요청과 응답을 PSR-7에 맞는 구현체로 변환합니다.

composer require symfony/psr-http-message-bridge

composer require zendframework/zend-diactoros

이 라이브러리들을 설치하였다면 단순히 request를 라우트나 컨트롤러에 타입힌트하는 것만으로도 PSR-7 request를 얻을 수 있습니다.

use Psr\Http\Message\ServerRequestInterface;

Route::get('/', function (ServerRequestInterface $request) {
    //
});

라우트나 컨트롤러에서 반환된 PSR-7 response 인스턴스는 자동으로 라라벨 response 인스턴스로 변환되어 프레임워크에 표시될 것입니다.

입력값 조회하기

입력값 조회하기

몇 개의 단순한 메소드들을 사용하면 Illuminate\Http\Request 인스턴스에서 모든 사용자 입력에 접근할 수 있습니다. 입력은 모든 HTTP 메소드에 대해서 동일한 방식으로 엑세스 되기 때문에 request를 위해 사용된 HTTP 메소드에 대해서는 전혀 걱정할 필요가 없습니다:

$name = $request->input('name');

input 메소드에 두번째 인자로 기본값을 전달할 수 있습니다. Request에 요청된 입력 값이 존재하지 않는다면 기본값이 반환됩니다:

$name = $request->input('name', 'Sally');

배열 입력을 가진 폼에서 동작할 때에는, 배열에 접근하기 위하여 "dot" 표기법을 사용할 수 있습니다:

$name = $request->input('products.0.name');

$names = $request->input('products.*.name');

JSON 입력 값 조회하기

애플리케이션에 JSON 요청이 전달되어 Content-Type 헤더 속성이 application/json 으로 지정되어 있다면 input 메소드를 통해서 JSON 데이터에 접근할 수 있습니다. 또한 "점" 문법을 통해서 JSON 배열의 깊이 있는 요소에도 접근할 수 있습니다.

$name = $request->input('user.name');

입력값이 존재하는지 확인하기

Request에 어떤 값이 존재하는지 확인하기 위해서 has 메소드를 사용할 수 있습니다. 값이 존재하면서 문자열이 비어있지 않을 때에만 has 메소드는 true를 반환합니다:

if ($request->has('name')) {
    //
}

모든 입력 데이터 조회하기

또한 all 메소드를 이용하여 모든 입력 데이터를 배열 형태로 조회할 수 있습니다.

$input = $request->all();

입력 데이터의 한 부분 조회하기

입력 데이터의 일부분만 조회하기 위해서 only와 except 메소드를 사용할 수 있습니다. 이 두 메소드 모두 하나의 배열 또는 동적인 인자의 목록을 받아 들입니다:

$input = $request->only(['username', 'password']);

$input = $request->only('username', 'password');

$input = $request->except(['credit_card']);

$input = $request->except('credit_card');

동적 속성

또한 Illuminate\Http\Request 인스턴스에서 동적 송석을 사용하여 사용자 입력에 엑세스 할 수 있습니다. 예를 들어, 애플리케이션의 form 중에 하나가 name 필드를 가지고 있다면, 다음과 같이 전달된 필드의 값에 엑세스 할 수 있습니다:

$name = $request->name;

동적 속성을 사용할 때, 라라벨은 먼저 request-요청에서 파라미터의 값을 찾아보고 라우트 파라미터를 찾습니다.

이전 입력값 확인하기

라라벨은 한 request의 입력을 다음 request 중에도 유지할 수 있도록 해줍니다. 이 기능은 특히 유효성 검사 오류를 감지한 후 폼을 다시 채워 넣을 때 유용합니다. 하지만 라라벨에 포함된 유효성 검사 서비스를 이용한다면 몇몇 유효성 검사 기능들이 자동으로 이 기능을 호출하기 때문에 수동으로 이 메소드들을 사용해야 할 가능성은 낮습니다:

입력값을 세션에 임시 저장하기

Illuminate\Http\Request 인스턴스의 flash 메소드는 현재의 입력들을 세션에 저장하여, 사용자의 다음 request 동안에도 값을 사용할 수 있게 해줍니다:

$request->flash();

flashOnly와 flashExcept 메소드를 이용하여 request 데이터의 부분을 세션에 임시 저장(flash)할 수 있습니다.

$request->flashOnly(['username', 'email']);

$request->flashExcept('password');

리다이렉트 할 때 입력값을 세션에 임시저장하기

대부분 이전 페이지로 리다이렉트 하면서 입력값을 임시 저장 하기를 원하기 때문에, 이를 위해 리다이렉트와 함께 입력값 임시 저장을 메소드 체이닝으로 사용할 수 있습니다.

return redirect('form')->withInput();

return redirect('form')->withInput($request->except('password'));

이전 데이터 조회하기

이전 Request 에서 저장된 입력값을 검색하기 위해서는 Request 인스턴스의 old 메소드를 사용하면 됩니다. old 메소드는 세션에 저장된 입력 데이터를 불러오기 위한 편리한 헬퍼를 제공합니다:

$username = $request->old('username');

라라벨은 글로벌 old 헬퍼 함수도 제공합니다. 블레이드 템플릿 안에서 지난 입력값을 보여주려면 old 헬퍼 함수를 사용하는 것이 보다 편리합니다. 주어진 문자열에 대한 이전 입력값이 존재하지 않는다면, null 이 반환될 것입니다:

<input type="text" name="username" value="{{ old('username') }}">

쿠기

Request 에서 쿠키 조회하기

모든 쿠키는 라라벨 프레임워크에서 인증 코드와 함께 암호화 됩니다. 이 것은 클라이언트가 변경되었을 때는, 쿠키가 유효하지 않다는 것을 의미합니다. Request에서 쿠키 값을 가져오기 위해서는 Illuminate\Http\Request 인스턴스에서 cookie 메소드를 사용하면 됩니다:

$value = $request->cookie('name');

새로운 쿠키를 Response 에 추가하기

라라벨은 새로운 Symfony\Component\HttpFoundation\Cookie 인스턴스를 생성하기 위한 간단한 팩토리의 역할을 하는 글로벌 cookie 헬퍼 함수를 제공합니다. 쿠키를 Response 인스턴스에 추가하려면 withCookie 메소드를 사용하면 됩니다:

$response = new Illuminate\Http\Response('Hello World');

$response->withCookie('name', 'value', $minutes);

return $response;

5년 동안 오랫동안 유지되는 쿠키를 만드려면 우선 인자 없이 cookie 헬퍼를 호출하고 forever 메소드를 반환된 쿠키 팩토리에 체이닝하면 됩니다:

$response->withCookie(cookie()->forever('name', 'value'));

파일처리

업로드된 파일 조회하기

file 메소드를 사용하여 Illuminate\Http\Request 인스턴스에 포함된 업로드된 파일에 접근할 수 있습니다. file 메소드로 반환된 객체는 파일과 상호작용할 수 있는 다양한 메소드를 제공하는 Symfony\Component\HttpFoundation\File\UploadedFile 클래스의 인스턴스이며 PHP SplFileInfo 클래스를 상속하고 입니다:

$file = $request->file('photo');

hasFile 메소드를 사용하면 request에 파일을 가지고 있는지 확인할 수 있습니다. if ($request->hasFile('photo')) { // }

성공적인 업로드 확인하기

파일의 존재 여부를 확인하는 것에 더하여, isValid 메소드를 통해 파일이 문제 없이 업로드 되었다는 것을 확인할 수 있습니다:

if ($request->file('photo')->isValid()) {
    //
}

업로드된 파일 이동하기

업로드된 파일을 새로운 위치로 옮기려면 move 메소드를 사용하면 됩니다. 이 메소드는 파일을 (PHP 설정에 따라) 임시업로드 위치에서 사용자가 원하는 위치로 옮겨집니다:

$request->file('photo')->move($destinationPath);

$request->file('photo')->move($destinationPath, $fileName);

기타 파일 관련 메소드들

UploadedFile 인스턴스에 다양한 다른 메소드들이 제공되어 있습니다. 이 메소드들에 대해 더 많은 정보를 얻으려면 클래스의 API documentation을 확인해보십시오.

HTTP Requests

• Accessing The Request
  • Basic Request Information
  • PSR-7 Requests
• Retrieving Input
  • Old Input
  • Cookies
  • Files

Accessing The Request

To obtain an instance of the current HTTP request via dependency injection, you should type-hint the Illuminate\Http\Request class on your controller constructor or method. The current request instance will automatically be injected by the service container:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * Store a new user.
     *
     * @param  Request  $request
     * @return Response
     */
    public function store(Request $request)
    {
        $name = $request->input('name');

        //
    }
}

If your controller method is also expecting input from a route parameter, simply list your route arguments after your other dependencies. For example, if your route is defined like so:

Route::put('user/{id}', 'UserController@update');

You may still type-hint the Illuminate\Http\Request and access your route parameter id by defining your controller method like the following:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * Update the specified user.
     *
     * @param  Request  $request
     * @param  string  $id
     * @return Response
     */
    public function update(Request $request, $id)
    {
        //
    }
}

Basic Request Information

The Illuminate\Http\Request instance provides a variety of methods for examining the HTTP request for your application and extends the Symfony\Component\HttpFoundation\Request class. Here are a few more of the useful methods available on this class:

Retrieving The Request URI

The path method returns the request's URI. So, if the incoming request is targeted at http://domain.com/foo/bar, the path method will return foo/bar:

$uri = $request->path();

The is method allows you to verify that the incoming request URI matches a given pattern. You may use the * character as a wildcard when utilizing this method:

if ($request->is('admin/*')) {
    //
}

To get the full URL, not just the path info, you may use the url or fullUrl methods on the request instance:

// Without Query String...
$url = $request->url();

// With Query String...
$url = $request->fullUrl();

You may also get the full URL and append query parameters. For example, if the request is targeted at http://domain.com/foo, the following method will return http://domain.com/foo?bar=baz:

$url = $request->fullUrlWithQuery(['bar' => 'baz']);

Retrieving The Request Method

The method method will return the HTTP verb for the request. You may also use the isMethod method to verify that the HTTP verb matches a given string:

$method = $request->method();

if ($request->isMethod('post')) {
    //
}

PSR-7 Requests

The PSR-7 standard specifies interfaces for HTTP messages, including requests and responses. If you would like to obtain an instance of a PSR-7 request, you will first need to install a few libraries. Laravel uses the Symfony HTTP Message Bridge component to convert typical Laravel requests and responses into PSR-7 compatible implementations:

composer require symfony/psr-http-message-bridge

composer require zendframework/zend-diactoros

Once you have installed these libraries, you may obtain a PSR-7 request by simply type-hinting the request type on your route or controller:

use Psr\Http\Message\ServerRequestInterface;

Route::get('/', function (ServerRequestInterface $request) {
    //
});

If you return a PSR-7 response instance from a route or controller, it will automatically be converted back to a Laravel response instance and be displayed by the framework.

Retrieving Input

Retrieving An Input Value

Using a few simple methods, you may access all user input from your Illuminate\Http\Request instance. You do not need to worry about the HTTP verb used for the request, as input is accessed in the same way for all verbs:

$name = $request->input('name');

You may pass a default value as the second argument to the input method. This value will be returned if the requested input value is not present on the request:

$name = $request->input('name', 'Sally');

When working on forms with array inputs, you may use "dot" notation to access the arrays:

$name = $request->input('products.0.name');

$names = $request->input('products.*.name');

Retrieving JSON Input Values

When sending JSON requests to your application, you may access the JSON data via the input method as long as the Content-Type header of the request is properly set to application/json. You may even use "dot" syntax to dig deeper into JSON arrays:

$name = $request->input('user.name');

Determining If An Input Value Is Present

To determine if a value is present on the request, you may use the has method. The has method returns true if the value is present and is not an empty string:

if ($request->has('name')) {
    //
}

Retrieving All Input Data

You may also retrieve all of the input data as an array using the all method:

$input = $request->all();

Retrieving A Portion Of The Input Data

If you need to retrieve a sub-set of the input data, you may use the only and except methods. Both of these methods will accept a single array or a dynamic list of arguments:

$input = $request->only(['username', 'password']);

$input = $request->only('username', 'password');

$input = $request->except(['credit_card']);

$input = $request->except('credit_card');

Dynamic Properties

You may also access user input using dynamic properties on the Illuminate\Http\Request instance. For example, if one of your application's forms contains a name field, you may access the value of the posted field like so:

$name = $request->name;

When using dynamic properties, Laravel will first look for the parameter's value in the request payload and then in the route parameters.

Old Input

Laravel allows you to keep input from one request during the next request. This feature is particularly useful for re-populating forms after detecting validation errors. However, if you are using Laravel's included validation services, it is unlikely you will need to manually use these methods, as some of Laravel's built-in validation facilities will call them automatically.

Flashing Input To The Session

The flash method on the Illuminate\Http\Request instance will flash the current input to the session so that it is available during the user's next request to the application:

$request->flash();

You may also use the flashOnly and flashExcept methods to flash a sub-set of the request data into the session:

$request->flashOnly(['username', 'email']);

$request->flashExcept('password');

Flash Input Into Session Then Redirect

Since you often will want to flash input in association with a redirect to the previous page, you may easily chain input flashing onto a redirect using the withInput method:

return redirect('form')->withInput();

return redirect('form')->withInput($request->except('password'));

Retrieving Old Data

To retrieve flashed input from the previous request, use the old method on the Request instance. The old method provides a convenient helper for pulling the flashed input data out of the session:

$username = $request->old('username');

Laravel also provides a global old helper function. If you are displaying old input within a Blade template, it is more convenient to use the old helper. If no old input exists for the given string, null will be returned:

<input type="text" name="username" value="{{ old('username') }}">

Cookies

Retrieving Cookies From The Request

All cookies created by the Laravel framework are encrypted and signed with an authentication code, meaning they will be considered invalid if they have been changed by the client. To retrieve a cookie value from the request, you may use the cookie method on the Illuminate\Http\Request instance:

$value = $request->cookie('name');

Attaching A New Cookie To A Response

Laravel provides a global cookie helper function which serves as a simple factory for generating new Symfony\Component\HttpFoundation\Cookie instances. The cookies may be attached to a Illuminate\Http\Response instance using the withCookie method:

$response = new Illuminate\Http\Response('Hello World');

$response->withCookie('name', 'value', $minutes);

return $response;

To create a long-lived cookie, which lasts for five years, you may use the forever method on the cookie factory by first calling the cookie helper with no arguments, and then chaining the forever method onto the returned cookie factory:

$response->withCookie(cookie()->forever('name', 'value'));

Files

Retrieving Uploaded Files

You may access uploaded files that are included with the Illuminate\Http\Request instance using the file method. The object returned by the file method is an instance of the Symfony\Component\HttpFoundation\File\UploadedFile class, which extends the PHP SplFileInfo class and provides a variety of methods for interacting with the file:

$file = $request->file('photo');

You may determine if a file is present on the request using the hasFile method:

if ($request->hasFile('photo')) {
    //
}

Validating Successful Uploads

In addition to checking if the file is present, you may verify that there were no problems uploading the file via the isValid method:

if ($request->file('photo')->isValid()) {
    //
}

Moving Uploaded Files

To move the uploaded file to a new location, you should use the move method. This method will move the file from its temporary upload location (as determined by your PHP configuration) to a more permanent destination of your choosing:

$request->file('photo')->move($destinationPath);

$request->file('photo')->move($destinationPath, $fileName);

Other File Methods

There are a variety of other methods available on UploadedFile instances. Check out the API documentation for the class for more information regarding these methods.