آموزش View Composer در لاراول

سرفصل‌های مقاله

راه معمولی :
انتقال داده‌ها به صورت Global :

در این مقاله به آموزش استفاده ی یکی از بهترین امکانات لاراول یعنی View Composer می‌پردازیم. فرض کنید می‌خواهید تعداد زیادی از داده‌های database را در صفحات مختلف سایت به کاربر نمایش دهید. ساده‌ترین راه این است که در Controller داده‌ها را از Model بگیریم و به View ارسال کنیم. این کار تا زمانی که تعداد صفحات سایت کم باشد، تقریبا راهی معقول است. اما زمانی که سایت ما گسترش یابد، با مشکلاتی روبرو می‌شویم که به یک راه جایگزین نیاز پیدا می‌کنیم. این راه همان استفاده از View Composer است که در ادامه برای درک بهتر تفاوت‌ها ابتدا راه معمولی را می‌گوییم، سپس آن را با View Composer مقایسه می‌کنیم. همچنین برای تفهیم بیشتر View Composer در لاراول مطالب یک پروژه ی کوچک که می‌خواهد نام چند ماشین را نمایش دهد، پیاد ه سازی می‌کنیم.

راه معمولی :

روشی که ما در این آموزش به آن می‌پردازیم. ابتدا ساخت route، سپس controller و بعد از آن view است.

ساخت Route :

برای ساخت یک route در آدرس routes/web.php به صورت زیر عمل می‌کنیم.

<?php
use Illuminate\Support\Facades\Route;
Route::get('cars','CarsController@index');

ساخت Controller :

توسط دستور زیر یک Controller به نام CarsController را ایجاد می‌کنیم.

$ php artisan make:controller CarsController

همان طور که مشاهده می‌کنید، برای نمایش داده‌ها route به CarsController می‌رود و تابع index را می‌خواند. پس تابع index را در CarsController ایجاد می‌کنیم و نام تمام ماشین‌ها که از قبل در database ایجاد کردیم را از Model می‌گیریم و به یک View ارسال می‌کنیم.

<?php
namespace App\Http\Controllers;
use App\Cars;
use Illuminate\Http\Request;
class CarsController extends Controller
{
    public function index()
    {
       $cars=Cars::all();
       return view('cars.index',compact('cars'));
    }
}

توجه کنید که حتما model خود را در بالا use کرده باشید.

ساخت View :

اگر به تابع index در Controller توجه کرده باشید، می‌بینید که cars به یک View به نام cars.index توسط تابع compact ارسال می‌شود. پس در این مرحله به ساخت View می‌پردازیم. برای ساخت View ابتدا پوشه ای به نام cars در resources/views می‌سازیم. سپس فایل blade به نام index را به صورت زیر ایجاد می‌کنیم.

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Cars</title>
</head>
<body>
<ul>
   @foreach($cars as $car)
       <li>{{ $car->name }}</li>
    @endforeach
</ul>
</body>
</html>

نمايش داده‌ها در سایت :

حال در صفحه ی سایت مان نام تمام ماشين‌ها به صورت زیر نمايش داده می‌شود، که این همان راه معمولی و همیشگی است. List

همان طور که مشاهده کردید، ما فقط برای یک صفحه از سایت یعنی صفحه ی cars/ نیاز به ساخت Controller و سپس View داریم. فرض کنید که سایت ما دارای ۲۰ صفحه است که در تمام آن صفحات باید نام ماشین ها، به طور مثال در یک صفحه به ترتیب قیمت، در صفحه ی دیگر به ترتیب سال تولید و در صفحات مختلف به ترتیب‌های دیگری نمایش داده شود. در این صورت ساخت حداقل یک Controller برای هر کدام از آن‌ها دیگر بهترین راه نیست و View Composer بهترین جایگزین است.

انتقال داده‌ها به صورت Global :

برای آشنایی با View Composer ابتدا می‌خواهیم یاد بگیریم که چگونه می‌توانیم داده‌ها را به جای چند Controller تنها در یک قسمت وارد کنیم تا تمام View‌ها به آن دسترسی داشته باشند. برای این کار به app/Providers/AppServiceProvider.php بروید و در تابع boot دستور زیر را وارد کنید.

<?php
namespace App\Providers;
use App\Cars;
use Illuminate\Support\Facades\View;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
         View::share('cars', Cars::orderBy('name')->get());
    }
    public function register()
    {
        //
    }
}

ما از کلاس View، متد share را فراخوانی کردیم که پارامتر اول آن نام متغیر یعنی cars$ و پارامتر دوم مقدار cars$ است. (توجه کنید که از علامت $ در پارامتر‌ها استفاده نکنید.) حال اگر در CarsController خط زیر و مقدار compact را پاک کنید و به صفحه ی سایت بروید، مشاهده می‌کنید که تمامی داده‌ها مثل قبل، البته به ترتیب نام وجود دارند.

مشکلات این روش :

وقتی که یک متغیر را به صورت بالا در AppServiceProvider و به صورت Global تعریف می‌کنیم. به طور خودکار این متغیر به تمام View‌ها چه بخواهیم، چه نخواهیم ارسال می‌شود و این کار database را بیهوده اشغال می‌کند. [ltitle]View Composer در لاراول :[/ltitle] View Composer مانند روش بالاست با این تفاوت که می‌توانیم تعیین کنیم که متغیرمان به کدام View‌ها ارسال شود.

<?php
namespace App\Providers;
use App\Cars;
use Illuminate\Support\Facades\View;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        // Option 2
        View::composer(['cars.index','cars.buy'], function($view)
        {
            $view->with('cars', Cars::orderBy('name')->get())
        });
    }
    public function register()
    {
        //
    }
}

ما از کلاس View، متد composer را فراخوانی کردیم که پارامتر اول آن صفحاتی که می‌خواهیم متغیر به آن ارسال شود و پارامتر دوم یک تابع callback است که مانند View::share عمل می‌کند و می‌توانید همان اطلاعاتی که در View::share وارد کردید در with هم وارد کنید. همچنین اگر می‌خواهید به طور مثال متغیر به تمام View‌های درون یک پوشه ارسال شود کافی است به جای نام یک View علامت * را به صورت زیر بگذارید.

View::composer(['cars.*'], function($view)
        {
            $view->with('cars', Cars::orderBy('name')->get())
        });

حال اگر به طور مثال بخواهیم که داده‌ها در یک صفحه به ترتیب نام، در صفحه ای دیگر به ترتیب قیمت، و در هر صفحه به شکل خاصی مرتب شوند می‌توانیم در app/Http یک پوشه به نام View بسازیم و در آن پوشه ای به نام Composers ایجاد کنیم. بعد از ایجاد پوشه ی Compossers در آن یک Class به نام CarsComposer بسازید و درون CarsComposer کد زیر را وارد کنید :

<?php
namespace App\Http\View\Composers;
use App\Cars;
use Illuminate\View\View;
class CarsComposser
{
    public function compose(View $view)
    {
        $view->with('cars', Cars::all());
    }
}

همان دستوراتی که در تابع callback هنگام استفاده از View::composer وارد کردیم را در تابع compose کلاس بالا تعریف می‌کنیم. سپس به AppServiceProvider رفته و View::composer را به صورت زیر تغییر می‌دهیم :

<?php
namespace App\Providers;
use App\Cars;
use App\Http\View\Composers\CarsComposser;
use Illuminate\Support\Facades\View;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        //Option 3
        View::composer(['cars.index','cars.buy'],CarsComposser::class);
    }
    public function register()
    {
        //
    }
}

همچنین امكان دارد چندین View مختلف، در چندین پوشه ی مختلف قرار داشته باشد. به طور مثال فرض کنید که شما ۱۰ پوشه که در هر پوشه ۵ View قرار دارد را دارید. در این صورت وارد کردن View‌ها کاری تقریبا زمانبر است. پس بهتر است از راه جایگزین استفاده کنید. بدین منظور قسمت هایی از View که دارای متغیر cars می‌باشد یعنی:

@foreach($cars as $car)
       <li>{{ $car->name }}</li>
@endforeach

را به پوشه ای مانند پوشه ی partials می‌بریم و در view خود آن را include می‌کنیم.

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Cars</title>
</head>
<body>
<ul>
@include('partials.list')
</ul>
</body>
</html>

سپس appServiceProvider را از

public function boot()
    {
        //Option 3
        View::composer(['cars.index','cars.buy'],CarsComposser::class);
    }

به

public function boot()
    {
        //Option 3
        View::composer('partials.*',CarsComposser::class);
    }

تغییر می‌دهیم. جمع بندی: در این مقاله سعی ما از ابتدا بر این بود، که مفاهيم را هر چه بهتر و در قالب یک پروژه ی کوچک، همراه با مقایسه نسبت به روش‌های دیگر به شما آموزش بدهیم. حال شما می‌توانید از این قابلیت بزرگ لاراول در پروژه‌های خود همان گونه که می‌خواهید استفاده کنید. در صورت داشتن هرگونه سوال یا تجربه ای در این زمینه، آن را در قسمت نظرات با ما به اشتراک بگذارید.

اگر به یادگیری بیشتر لاراول علاقه داری می‌تونی در دوره آموزش لاراول کاربردی (بسته پروژه محور) شرکت کنی، این دوره شامل ۱۲ پروژه کاربردی و پر استفاده در دنیای واقعی است، که تمامی پروژه‌ها به صورت کامل برنامه نویسی خواهند شد، تا دانشجو بتواند با روند ایجاد و تکمیل پروژه به صورت کامل آشنا شود.