뷰(Views)

기본 사용법
뷰 컴포저

기본 사용법

뷰는 응용 프로그램에서 제공하는 HTML을 포함하고 프리젠 테이션 로직 컨트롤러 및 도메인 로직을 분리하는 편리한 방법을 제공합니다. 뷰파일들은 resources/views 디렉토리에 위치합니다.

간단한 뷰는 다음과 같습니다:

<!-- View stored in resources/views/greeting.php -->

<html>
    <body>
        <h1>Hello, <?php echo $name; ?></h1>
    </body>
</html>

뷰는 다음과 같이 브라우저로 보내집니다:

Route::get('/', function()
{
    return view('greeting', ['name' => 'James']);
});

보는바와 같이 view 헬퍼함수에 전달하는 첫 번째 인자는 resources/views 디렉토리에 있는 파일의 이름이 됩니다. 두 번째 전달 인자는 뷰에서 사용하기위한 데이터의 배열입니다.

\당연하게도 뷰는 resources/views 디렉토리의 중첩된 서브 디렉토리를 구성할 수 있습니다. 예를 들어, 뷰파일이 resources/views/admin/profile.php처럼 저장되었다면 다음처럼 호출해야 합니다:

return view('admin.profile', $data);

뷰에 데이터 전달하기

// Using conventional approach
$view = view('greeting')->with('name', 'Victoria');

// Using Magic Methods
$view = view('greeting')->withName('Victoria');

위 예제의 경우 뷰에서는 $name 변수에 Victoria라는 값을 확인할 수 있습니다.

필요한 경우에 view 헬퍼함수에 두 번째 인자로 데이터 배열을 전달할 수도 있습니다:

$view = view('greetings', $data);

이러한 방식으로 정보를 전달할 때,$data는 키/값으로 구성된 배열이어야 합니다. 뷰 안에서 여러분은 {{ $key }}와 같이 각각의 키에 해당하는 값에 엑세스 할 수 있습니다. ($data['$key']는 존재한다고 가정합니다. )

모든 뷰에서 데이터 공유하기

때때로 어플리케이션에서 표시하는 모든 뷰에서 데이터를 공유할 필요가 있을 수도 있습니다. 이 경우 몇 가지의 옵션이 있습니다. view 헬퍼 함수를 사용하거나 Illuminate\Contracts\View\Factory contract를 이용하는 법, 또는 와일드 카드의 view composer를 통하는 방법입니다.

view 헬퍼함수를 이용하는 예제입니다.

view()->share('data', [1, 2, 3]);

View 파사드를 사용할 수도 있습니다.

View::share('data', [1, 2, 3]);

일반적으로 share 메소드는 서비스 프로바이더의 boot 메소드 안에서 호출합니다. AppServiceProvider에서 편하게 추가할수도 있고, 다른 별도의 서비스 프로바이더를 생성하고 구성할 수도 있습니다.

** 참고:** view 헬퍼함수를 전달 인자 없이 호출하는 경우에는 반환값은 Illuminate\Contracts\View\Factory contract의 구현체가 됩니다.

뷰가 존재하는지 판단하기

뷰 파일이 존재하는 판단해야될 필요가 있다면 exists 메소드를 사용하면 됩니다:

if (view()->exists('emails.customer'))
{
    //
}

파일 패스로부터 view 반환

필요하다면 절대경로를 기반으로 뷰를 생성할 수도 있습니다:

return view()->file($pathToFile, $data);

뷰 컴포저

뷰 컴포저는 뷰가 렌더링 될 때 호출되는 콜백 또는 클래스 메소드입니다. 만약 뷰가 렌더링 될 때마다 뷰에 전달해야 할 데이터를 가지고 있다면 뷰 컴포저는 해당 로직을 한곳에서 구성할수 있게해줍니다.

뷰 컴포저 정의하기

뷰 컴포저를 서비스 프로바이더를 통해서 구성해 봅시다. Illuminate\Contracts\View\Factory contract 구현체에 엑세스 하기 위해서 View 파사드를 사용할 것입니다:

<?php namespace App\Providers;

use View;
use Illuminate\Support\ServiceProvider;

class ComposerServiceProvider extends ServiceProvider {

    /**
     * Register bindings in the container.
     *
     * @return void
     */
    public function boot()
    {
        // Using class based composers...
        View::composer('profile', 'App\Http\ViewComposers\ProfileComposer');

        // Using Closure based composers...
        View::composer('dashboard', function($view)
        {

        });
    }

    /**
     * Register the service provider.
     *
     * @return void
     */
    public function register()
    {
        //
    }

}

참고: 라라벨은 뷰 컴포저를 위한 디렉토리를 기본적으로 포함하고 있지는 않습니다. 여러분이 원하시는대로 편하게 구성하면 됩니다. 예를 들어, App\Http\ViewComposers 디렉토리를 새롭게 생성할 수 있습니다.

기억해야 될 부분은 생성한 서비스 프로바이더를 config/app.php 설정 파일의 providers 배열에 추가해야한다는 것입니다.

이제 뷰 컴포저를 등록했다면 profile 뷰가 렌더링 될 때마다 ProfileComposer@compose 메소드가 실행될 것입니다. 이제 컴포저 클래스를 정의해봅시다.

<?php namespace App\Http\ViewComposers;

use Illuminate\Contracts\View\View;
use Illuminate\Users\Repository as UserRepository;

class ProfileComposer {

    /**
     * The user repository implementation.
     *
     * @var UserRepository
     */
    protected $users;

    /**
     * Create a new profile composer.
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        // Dependencies automatically resolved by service container...
        $this->users = $users;
    }

    /**
     * Bind data to the view.
     *
     * @param  View  $view
     * @return void
     */
    public function compose(View $view)
    {
        $view->with('count', $this->users->count());
    }

}

뷰가 렌더링되기 전에 뷰 컴포저의 composer 메소드가 Illuminate\Contracts\View\View 인스턴스와 함께 호출됩니다. 데이터를 전달하기 위해서 with 메소드를 사용할 수 있습니다.

참고: 모든 뷰 컴포저의 의존성 주입은 service container,를 통해서 이루어 집니다. 그렇기 때문에 필요한 객체의 경우 뷰 컴포저의 생성자에서 타입힌트를 지정한 형태로 지정하면 됩니다.

와일드카드 뷰 컴포저

composer 메소드는 * 와일드 캐릭터로 인자를 받을 수 있는데 이렇게 하면 모든 뷰에 뷰 컴포저를 지정하게 됩니다:

View::composer('*', function($view)
{
    //
});

컴포저에 다수의 뷰들 지정하기

뷰 컴포저에 뷰를 지정할 때 한번에 여러 뷰를 지정할 수 있습니다.

View::composer(['profile', 'dashboard'], 'App\Http\ViewComposers\MyViewComposer');

다수의 컴포저 정의하기

composers 메소드를 사용하면 한번에 컴포저를 그룹지어 등록할 수 있습니다:

View::composers([
    'App\Http\ViewComposers\AdminComposer' => ['admin.index', 'admin.profile'],
    'App\Http\ViewComposers\UserComposer' => 'user',
    'App\Http\ViewComposers\ProductComposer' => 'product'
]);

뷰 크리에이터

뷰 크리에이터는 뷰 컴포저와 거의 비슷하게 동작합니다; 하지만 뷰 크리에이터는 뷰가 인스턴스화 되는 즉시 실행됩니다. 뷰 크리에이터를 등록하기 위해서는 creator 메소드를 사용합니다:

View::creator('profile', 'App\Http\ViewCreators\ProfileCreator');