بعد أن انتهينا من إعداد المشروع وإنشاء توابع وعروض الإنشاء والتخزين والعرض، سوف نقوم في درسنا الأخير اليوم بكتابة الشيفرة البرمجية لتوابع التعديل والتحديث والحذف ومن ثم العروض الموافق لها.

تابع Edit

إن توابع وعروض edit وdelete غير موجودة لحد الساعة، فلننشئها، سنبدأ بالعمل على edit أولا.
عدل على تابع المتحكم:

public function edit($id)
{
   $marketingImage = Marketingimage::findOrFail($id);
   return view('marketingimage.edit', compact('marketingImage'));
}

مرة أخرى قمنا باستخدام تابع findOrFail وقمنا بإرسال الكائن إلى العرض لأننا نريد أن نقوم بتعبئة الاستمارة مسبقا بالقيم المناسبة من سجلات البيانات.

عرض Edit

عدل على ملف views/marektingimage/edit.blade.php ليكون كالتالي:

@extends('layouts.master')

@section('content')
   {!! Breadcrumb::withLinks(['Home'   => '/',
                              'marketing images' => '/marketingimage',
                              "edit $marketingImage->image_name.$marketingImage->image_extension"
                               ]) !!}

    <h1>Edit {{ $marketingImage->image_name. '.' . $marketingImage->image_extension }} </h1>
    <hr/>

    @if (count($errors) > 0)
       <div class="alert alert-danger">
         <strong>Whoops! </strong> There were some problems with your input. <br> <br>
           <ul>
             @foreach ($errors->all() as $error)
               <li>{{ $error }} </li>
             @endforeach
           </ul>
       </div>
    @endif

    <div>
       Note: name and path values cannot be changed.  If you wish to change these, then delete and create a new photo:
    </div>
    <br>


   {!! Form::model($marketingImage, ['route' => ['marketingimage.update', $marketingImage->id],
                          'method' => 'PATCH',
                          'class' => 'form',
                          'files' => true]
                          ) !!}

    <!-- image name Form Input -->
    <div>
      <ul>
        <li> <h4>Image Name:   {{ $marketingImage->image_name. '.' . $marketingImage->image_extension }}   </h4> </li>
        <li> <h4>Image Path:   {{ $marketingImage->image_path }}  </h4>  </li>
        <li> <h4>Mobile Name:   {{ $marketingImage->mobile_image_name. '.' . $marketingImage->mobile_extension }}  </h4>  </li>
        <li> <h4>Mobile Path:   {{ $marketingImage->mobile_image_path }}  </h4> </li>
      </ul>
    </div>

    <!-- is_something Form Input -->
    <div class="form-group">
       {!! Form::label('is_active', 'Is Active:') !!}
       {!! Form::checkbox('is_active') !!}
    </div>

    <!-- is_featured Form Input -->
    <div class="form-group">
       {!! Form::label('is_featured', 'Is Featured:') !!}
       {!! Form::checkbox('is_featured') !!}
    </div>

    <!-- form field for file -->
    <div class="form-group">
       {!! Form::label('image', 'Primary Image') !!}
       {!! Form::file('image', null, array('class'=>'form-control')) !!}
    </div>

    <!-- form field for file -->
    <div class="form-group">
       {!! Form::label('mobile_image', 'Mobile Image') !!}
       {!! Form::file('mobile_image', null, array('class'=>'form-control')) !!}
    </div>

    <div class="form-group">
       {!! Form::submit('Edit', array('class'=>'btn btn-primary')) !!}
    </div>

   {!! Form::close() !!}
    <div>
       {!! Form::model($marketingImage, ['route' => ['marketingimage.destroy', $marketingImage->id],
       'method' => 'DELETE',
       'class' => 'form',
       'files' => true]
       ) !!}

        <div class="form-group">
           {!! Form::submit('Delete Photos', array('class'=>'btn btn-danger', 'Onclick' => 'return ConfirmDelete();')) !!}
        </div>

       {!! Form::close() !!}
    </div>
@endsection

@section('scripts')
    <script>
       function ConfirmDelete()
       {
           var x = confirm("Are you sure you want to delete?");
           if (x)
               return true;
           else
               return false;
       }
    </script>
@endsection

لم نسمح للمستخدم بتعديل أسماء الصور أومساراتها لأننا نريدهم أن يقوموا بحذف السجلات والبدء من جديد وإلا سيكون الأمر معقدا عندما نقوم بتعديل الأسماء التي قمنا بحفظها في السجلات وهذا الأمر لا يدخل في نطاق الدرس.

ماهي الاختلافات الأخرى في الاستمارة ؟ سوف تلاحظ أننا نستخدم حقول أقل وقمنا باستخدام الربط بين النموذج والاستمارة في مساعدي الاستمارة (form helper):

{!! Form::model($marketingImage, ['route' => ['marketingimage.update', $marketingImage->id],
                                 'method' => 'PATCH',
                                 'class' => 'form',
                                 'files' => true]
) !!}

إن مثيل النموذج marketingImage$ مرتبط بالاستمارة لذلك سيتم تعبئة الحقول بشكل مسبق، ولاحظ أننا قمنا أيضا بتحديد marketingImage->id$ حتى نتمكن من إرسال ذلك إلى تابع المتحكم وتعديل السجل الصحيح.

ولقد قمنا بتعيين قيمة PATCH إلى method وهذه سوف تتغير تلقائيا لأن HTML لا يدعم PATCH، ولقد قمنا بتعيين قيمة true إلى files حتى نتمكن من إرسال الملفات.

بقية الشيفرة سهلة وقمنا بشرحها سابقا، لاحظ أننا قمنا بوضع زر للحذف في الأسفل في حالة ما أراد المستخدم الحذف بدل التعديل.
عند سير العمل بطريقة عادية، سوف تكون خطوتك القادمة في الغالب الانتقال إلى تابع update في MarketingImagesController لكننا سنقوم بإنشاء صنف request للتعامل مع سيناريو update.

EditImageRequest

الفرق في عملية التحقق بين create و update هو أنه عندما تقوم بإنشاء صورة سيكون ملف الصورة إلزاميا على عكس التحديث، لذلك قررت لأجل البساطة والوضوح أن نقوم بإنشاء صنف request منفصل باسم EditImageRequest بدلا من وضعه في صنف request واحد.

المشكلة التي واجهتها هي أنني لا أعرف كيف أجعلها شرطية فعلى أي تابع يجب وضع الصنف، لذلك بدأت في التفكير في الأمر، فبدلا من ذلك، يمكنني أن أقوم بتمرير حقل خفي والذي سوف يُعرف الاستمارة وسوف أقوم بوضع فيه عنصر تحكم منطقي (controlling logic)، فإذا كانت الاستمارة استمارة create، فستكون الصور إلزامية، لكنني في النهاية قررت أنه من الأسهل أن أقوم بعمل صنف منفصل.

لذلك قم بتنفيذ هذا الأمر من سطر الأوامر:

php artisan make:request EditImageRequest

ثم قم بتعيين قيمة return true في تابع authorize في ذلك الصنف وعدل تابع rules إلى التالي:

public function rules()
{
   return [
       'is_active' => 'boolean',
       'is_featured' => 'boolean',
       'image' => 'mimes:jpeg,jpg,bmp,png | max:1000',
       'mobile_image' => 'mimes:jpeg,jpg,bmp,png | max:1000'
   ];
}

قمنا بالفعل بالتحدث عن تابع rules سابقا ولا داعي لإعادة شرحه هنا.

تابع Update

لنقم الآن بالانتقال إلى تابع update في MarketingImageController، عدله كما يلي:

public function update($id, EditImageRequest $request)
{
   $marketingImage = Marketingimage::findOrFail($id);

   $marketingImage->is_active = $request->get('is_active');
   $marketingImage->is_featured = $request->get('is_featured');

   $this->formatCheckboxValue($marketingImage);
   $marketingImage->save();

   if ( ! empty(Input::file('image'))){

       $destinationFolder = '/imgs/marketing/';
       $destinationThumbnail = '/imgs/marketing/thumbnails/';

       $file = Input::file('image');

       $imageName = $marketingImage->image_name;
       $extension = $request->file('image')->getClientOriginalExtension();

       //create instance of image from temp upload
       $image = Image::make($file->getRealPath());

       //save image with thumbnail
       $image->save(public_path() . $destinationFolder . $imageName . '.' . $extension)
           ->resize(60, 60)
           // ->greyscale()
           ->save(public_path() . $destinationThumbnail . 'thumb-' . $imageName . '.' . $extension);

   }

   if ( ! empty(Input::file('mobile_image'))) {

       $destinationMobile = '/imgs/marketing/mobile/';
       $mobileFile = Input::file('mobile_image');

       $mobileImageName = $marketingImage->mobile_image_name;
       $mobileExtension = $request->file('mobile_image')->getClientOriginalExtension();

       //create instance of image from temp upload
       $mobileImage = Image::make($mobileFile->getRealPath());
       $mobileImage->save(public_path() . $destinationMobile . $mobileImageName . '.' . $mobileExtension);
   }

   flash()->success('image edited!');
   return view('marketingimage.edit', compact('marketingImage'));
}

دعونا نبدأ بتوقيع التابع:

public function update($id, EditImageRequest $request)
{

سوف ترى أننا نقوم بسحب مثيل من كائن request الصحيح، وقمنا باستخدام findOrFail في نموذج السجل حتى نتمكن من تعيين القيم من مثيل request، وبعد ذلك قمنا بتهيئة (format) قيم خانة الاختيار (checkbox) ثم حفظناها:

   $marketingImage = Marketingimage::findOrFail($id);

   $marketingImage->is_active = $request->get('is_active');
   $marketingImage->is_featured = $request->get('is_featured');

   $this->formatCheckboxValue($marketingImage);
   $marketingImage->save();

إذا لم تكن الصورة الأولية فارغة، سوف نقوم بالتحديث:

if ( ! empty(Input::file('image'))){

   $destinationFolder = '/imgs/marketing/';
   $destinationThumbnail = '/imgs/marketing/thumbnails/';

   $file = Input::file('image');

   $imageName = $marketingImage->image_name;
   $extension = $request->file('image')->getClientOriginalExtension();

   //create instance of image from temp upload
   $image = Image::make($file->getRealPath());

   //save image with thumbnail
   $image->save(public_path() . $destinationFolder . $imageName . '.' . $extension)
       ->resize(60, 60)
       // ->greyscale()
       ->save(public_path() . $destinationThumbnail . 'thumb-' . $imageName . '.' . $extension);

}

ثم سنفعل نفس الشيء على صور الهاتف:

if ( ! empty(Input::file('mobile_image'))) {

   $destinationMobile = '/imgs/marketing/mobile/';
   $mobileFile = Input::file('mobile_image');

   $mobileImageName = $marketingImage->mobile_image_name;
   $mobileExtension = $request->file('mobile_image')->getClientOriginalExtension();

   //create instance of image from temp upload
   $mobileImage = Image::make($mobileFile->getRealPath());
   $mobileImage->save(public_path() . $destinationMobile . $mobileImageName . '.' . $mobileExtension);
}

ثم قمنا بتنفيذ flash لـ success وبعد ذلك قمنا بالعودة return وفي حالتنا هذه إلى صفحة التعديل edit، لكن يمكنك تغيير العودة إلى أي صفحة تريدها:

flash()->success('image edited!');
return view('marketingimage.edit', compact('marketingImage'));

أرجو ملاحظة أنه إذا كنت تقوم بعمل هذا لشركة تطوير، ربما قد تريد أن تجعل هذه الشيفرة أقوى عن طريق التحقق من أن الملف قد تم إنشاءه، وسوف تتعامل مع الأمر بشكل مختلف إذا لم يعمل لبعض الأسباب، لكن كل هذا خارج نطاق الدرس.

حسنا، الآن آخر خطوة في درسنا.

تابع Destroy

سوف نحتاج إلى كتابة تابع destroy للتعامل مع حذف الصور:

public function destroy($id)
{
   $marketingImage = Marketingimage::findOrFail($id);
   $thumbPath = $marketingImage->image_path.'thumbnails/';

   File::delete(public_path($marketingImage->image_path).
                            $marketingImage->image_name . '.' .
                            $marketingImage->image_extension);

   File::delete(public_path($marketingImage->mobile_image_path).
                            $marketingImage->mobile_image_name . '.' .
                            $marketingImage->mobile_extension);
   File::delete(public_path($thumbPath). 'thumb-' .
                            $marketingImage->image_name . '.' .
                            $marketingImage->image_extension);

    Marketingimage::destroy($id);

   flash()->success('image deleted!');

   return redirect()->route('marketingimage.index');

}

يمكنك أن ترى أننا قمنا باستخدام findOrFail على id الذي تم استلامه عن طريق التوقيع، ثم استخدمنا مساعدي الملف (File helper) لـ Laravel للحذف، وهكذا تحصلنا مرة أخرى على صياغة جميلة لتبين لنا ما نقوم بفعله.
قمنا أيضا باستخدام تابع ()public_path ووضعنا مكونات الصورة داخل ذلك التوقيع، وبعد ذلك قمنا بتكرار نفس الأمر مع كل نوع من الصور مرتبط مع السجل، ثم استخدمنا تابع destroy لحذف السجل من قاعدة البيانات، وقمنا بتنفيذ flash لتابع success ومن ثم قمنا بإعادة التوجيه إلى صفحة index، وهاقد انتهينا.

خاتمة

لقد تعلمنا في هذه الدروس العديد من الطرق والمفاهيم الجديدة في Laravel، وعلى الرغم من بساطة التطبيق الذي قمنا بعمله إلا أنه سيكون بداية جيدة لاحتراف إدارة الصور في Laravel، وإذا كان لديك أي سؤال أو تعليق، فيسرنا أن نسمعه في التعليقات في الأسفل، وإذا أعجبتك هذه التدوينة، أرجو أن تقوم بمشاركتها مع أصدقاءك.

ترجمة -وبتصرّف- للدرس Basic Image Management Part 3 لصاحبه Bill Keck.

حقوق الصورة البارزة: Designed by Freepik.

في الحالة العادية، سوف تقوم بكتابة تابع (store method) أولا، ومن ثم تترك عملية التحقق في النهاية حتى يعمل store بشكل جيد، لكن في حالتنا هذه سيكون الأمر معقدا قليلا بما أننا نتعامل مع ملفات منفصلة يجب حفظها، ففي حالة الصور، سوف نحتاج إلى التحقق أولا.

صنف Request

سوف نبدأ بإنشاء صنف (request class) والذي سيقوم بالتعامل مع عملية التحقق من استمارة الإنشاء. سوف نبدأ بكتابة هذا الأمر على سطر الأوامر:

php artisan make:request CreateImageRequest

هذا الأمر سيقوم بإنشاء الملف ووضعه داخل مجلد app/Http/Requests.

بعد ذلك، عدل الملف كالتالي:

<?php
  namespace App\Http\Requests;

  use App\Http\Requests\Request;
  use App\Marketingimage;

  class CreateImageRequest extends Request
  {
    /**
    * Determine if the user is authorized to make this request.
    *
    * @return bool
    */
    public function authorize()
    {
      return true;
    }

    /**
    * Get the validation rules that apply to the request.
    *
    * @return array
    */
    public function rules()
    {
       return [
         'image_name' => 'alpha_num | required | unique:marketing_images',
         'mobile_image_name' => 'alpha_num | required | unique:marketing_images',
         'is_active' => 'boolean',
         'is_featured' => 'boolean',
         'image' => 'required | mimes:jpeg,jpg,bmp,png | max:1000',
         'mobile_image' => 'required | mimes:jpeg,jpg,bmp,png | max:1000'
       ];
    }
}

واحد من الأشياء التي أحبها في إطار Laravel هو كيفية تعامله مع عملية التحقق، فإذا كانت هذه المرة الأولى التي ستتعامل فيها مع عملية التحقق، سوف تجد أن هذه العملية بسيطة للغاية.

لاحظ أننا قمنا بكتابة السطر التالي في تابع authorize:

return true;

هذا السطر سوف يسمح للطلب أن يمر، فإذا وضعنا شرطا عليه فسنستطيع التحكم فيه، فعلى سبيل المثال، يمكننا استخدامه في تسجيل الدخول للأعضاء فقط.

بعد ذلك لدينا قواعد التابع، الذي سوف يتم فرضها على عملية التحقق في حقول الاستمارة، لن نتعمق أكثر هنا، فإذا أردت المزيد يمكنك الإطلاع على توثيق Laravel.

للتذكير فإننا نفصل ما بين قواعد التّحقق بمحرف "|" ولما نضيف قاعدة "unique" فإننا نُرفقها باسم الجدول الذي يجب أن نبحث فيه (يعني الجدول الذي نرغب في أن يكون السّجل record الذي نقوم بحفظه وحيدًا "unique").

ومن الطبيعي أننا أننا قمنا بإضافة قيد على حجم الملفات. يمكنك إيجاد قائمة كاملة من قواعد التحقق في الوثائق.

تابع Store

على أي حال، سوف ننتقل الآن لتابع store في MarketingImageController، عدل التابع كما يلي:

public function store(CreateImageRequest $request)
{
   //create new instance of model to save from form
   $marketingImage = new Marketingimage([
       'image_name'        => $request->get('image_name'),
       'image_extension'   => $request->file('image')->getClientOriginalExtension(),
       'mobile_image_name' => $request->get('mobile_image_name'),
       'mobile_extension'  => $request->file('mobile_image')->getClientOriginalExtension(),
       'is_active'         => $request->get('is_active'),
       'is_featured'       => $request->get('is_featured'),

   ]);

   //define the image paths
   $destinationFolder = '/imgs/marketing/';
   $destinationThumbnail = '/imgs/marketing/thumbnails/';
   $destinationMobile = '/imgs/marketing/mobile/';

   //assign the image paths to new model, so we can save them to DB
   $marketingImage->image_path = $destinationFolder;
   $marketingImage->mobile_image_path = $destinationMobile;

   // format checkbox values and save model
   $this->formatCheckboxValue($marketingImage);
   $marketingImage->save();

   //parts of the image we will need
   $file = Input::file('image');

   $imageName = $marketingImage->image_name;
   $extension = $request->file('image')->getClientOriginalExtension();

   //create instance of image from temp upload
   $image = Image::make($file->getRealPath());

   //save image with thumbnail
   $image->save(public_path() . $destinationFolder . $imageName . '.' . $extension)
       ->resize(60, 60)
       // ->greyscale()
       ->save(public_path() . $destinationThumbnail . 'thumb-' . $imageName . '.' . $extension);

   // now for mobile
   $mobileFile = Input::file('mobile_image');

   $mobileImageName = $marketingImage->mobile_image_name;
   $mobileExtension = $request->file('mobile_image')->getClientOriginalExtension();

   //create instance of image from temp upload
   $mobileImage = Image::make($mobileFile->getRealPath());
   $mobileImage->save(public_path() . $destinationMobile . $mobileImageName . '.' . $mobileExtension);


   // Process the uploaded image, add $model->attribute and folder name
   flash()->success('Marketing Image Created!');

   return redirect()->route('marketingimage.show', [$marketingImage]);
}

حسنا، دعونا نبدأ بفهم هذه الشفرة الطويلة، سنبدأ مع توقيع الدالة:

public function store(CreateImageRequest $request)

هذا الجزء واضح، فلقد قمنا فقط بسحب نسخة (instance) من كائن request يحمل الاسم request$ وهذا سوف يساعدنا على إنشاء نسخة جديدة للنموذج:

//create new instance of model to save from form

$marketingImage = new Marketingimage([
   'image_name'        => $request->get('image_name'),
   'image_extension'   => $request->file('image')->getClientOriginalExtension(),
   'mobile_image_name' => $request->get('mobile_image_name'),
   'mobile_extension'  => $request->file('mobile_image')->getClientOriginalExtension(),
   'is_active'         => $request->get('is_active'),
   'is_featured'       => $request->get('is_featured'),

]);

لاحظ أنني أقوم بالتعليق كثيرا على هذا التابع (method)، لأنه من السهل أن يربكك. على أي حال، قمنا بإنشاء مثيل جديد لـ Marketingimage ووضعنا خصائص النموذج باستخدام مثيل request$.

أما البقية الشيفرة، فلقد قُمنا بسحب البيانات من الاستمارة إذا نجحت في عملية التحقق. ثم سوف نحتاج إلى تعريف مسارات الصور:

//define the image paths

$destinationFolder = '/imgs/marketing/';
$destinationThumbnail = '/imgs/marketing/thumbnails/';
$destinationMobile = '/imgs/marketing/mobile/';

ملاحظة: حاولت أن أجعل هذه الأسماء بديهية قدر الإمكان.
بعد ذلك، سوف نقوم بتعيينها إلى النموذج حتى نتمكن من حفظهم في قاعدة البيانات.

//assign the image paths to new model, so we can save them to DB

$marketingImage->image_path = $destinationFolder;
$marketingImage->mobile_image_path = $destinationMobile;

نستطيع فعل هذا بطريقة أخرى، فيمكننا أن نقوم بتقديم معلومات المسار في الاستمارة أو يمكننا تخطي هذا كليا، لكن وجدت أن إبقاء المسار في قاعدة البيانات يجعل العمل مع الصور أسهل عندما نحتاج إلى استخدامها في العروض (views)، وهذا هو سبب استخدامنا هذه الطريقة.
ثم سنقوم بتهيئة (format) قيم خانة اختيار ومن ثم نقوم بحفظها:

// format checkbox values and save model

$this->formatCheckboxValue($marketingImage);
$marketingImage->save();

يمكنك أن ترى أنني أقوم بتسليم مثيل النموذج marketingImage$ إلى تابع formatCheckboxValue، وهو تابع قمت بعمله للتأكد من أن خانة الاختيار يتم التعامل معها بشكل جيد:

public function formatCheckboxValue($marketingImage)
{
   $marketingImage->is_active = ($marketingImage->is_active == null) ? 0 : 1;
   $marketingImage->is_featured = ($marketingImage->is_featured == null) ? 0 : 1;
}

بسبب نوع البيانات في قاعدة البيانات، يمكننا توفير فقط رقمين 0 و 1، لذلك نحتاج إلى التأكد من أننا نقوم بالتحويل بشكل صحيح من خانة الاختيار (checkbox) في الاستمارة (form). لقد قمنا بتسليمها إلى مثيل النموذج ومن ثم سيقوم بوضع الخصائص وفقا لذلك.
بعد ذلك نعود إلى تابع store، ونقوم ببساطة بالحفظ:

$marketingImage->save();

وهذا سوف يهتم بسجلات قاعدة البيانات، ومع ذلك، لانزال بحاجة إلى التعامل مع الملف. في البداية سوف نعمل على بعض أجزاء الصورة التي سنحتاجها:

//parts of the image we will need

$file = Input::file('image');

$imageName = $marketingImage->image_name;
$extension = $request->file('image')->getClientOriginalExtension();

بدلا من ذلك، يمكنك جعل بعض هذه الشفرات في سطر واحد (inline) لكنك ستحصل على سطور طويلة جدا بالإضافة إلى أن إبقائها هكذا أسهل للتتبع والفهم.
الآن سوف نحتاج إلى استخدام مكتبة الصور (Image library) لمساعدتنا على الخروج من هنا، سنقوم بإنشاء مثيل لهذه الصورة من الصور المرفوعة:

//create instance of image from temp upload
$image = Image::make($file->getRealPath());

بعد ذلك، سنقوم بحفظها وإنشاء صورة مصغرة والتي سنقوم بحفظها عن طريق سَلسَلة التوابع (chaining the methods):

//save image with thumbnail
$image->save(public_path() . $destinationFolder . $imageName . '.' . $extension)
   ->resize(60, 60)
   // ->greyscale()
   ->save(public_path() . $destinationThumbnail . 'thumb-' . $imageName . '.' . $extension);

سوف نقوم بتقسيم هذه الشيفرة إلى أجزاء حتى نفهمها بشكل أفضل، أول جزء يقوم بحفظ الصور الأولية:

$image->save(public_path() . $destinationFolder . $imageName . '.' . $extension)

استخدمنا ()public_path للوصول إلى المكان الذي يمكننا تعريف فيه مجلد الهدف (مجلد الصور) والذي هو imgs/marekting/.

بعد ذلك قمنا بسَلسَلة أجزاء الصورة (مسار ملف الصورة) التي نحتاجها وهذا سوف يعطينا كل شيء نحتاجه وسيسهل علينا عملية متابعة الشيفرة البرمجية.

بما أننا نحتاج أيضا إلى إنشاء صورة مصغرة، قمنا بسَلسَلة ذلك التابع:

->resize(60, 60)

وهذا السطر سوف ينشئ لنا نسخة بحجم 60 × 60 من الصورة، وإذا أردت تغيير حجم النسخة يمكنك فعل هذا بسهولة بتغيير الأرقام، ويمكنك أيضا إنشاء حقل في الاستمارة للمستخدمين لتحديد ارتفاع و عرض الصور المصغر. (لن نقوم بهذا في هذا الدرس.)

قمتُ بإرفاق (على شكل تعليق) تابع متسَلسَل لجعل الصورة المصغرة ذات تدرج رمادي، فإذا أردت صور مصغرة بيضاء وسوداء اجعل السطر شيفرة برمجية (عن طريق إزالة //).

والآن سنقوم بحفظ الصورة المصغرة:

->save(public_path() . $destinationThumbnail . 'thumb-' . $imageName . '.' . $extension);

وسنقوم بنفس الشيء لصور الهاتف:

// create instance of image from temp upload
$mobileImage = Image::make($mobileFile->getRealPath());
$mobileImage->save(public_path() . $destinationMobile . $mobileImageName . '.' . $mobileExtension);

يما أنها مثل الصور الأولية لكن بدون صورة مصغرة، سوف نتركها هكذا.

حسنا، بعد ذلك لدينا رسالة الفلاش (flash message):

flash()->success('Marketing Image Created!');

هذه الشيفرة لن تعمل إلا إذا قمت بتثبيت حزمة الفلاش لجفري ويِ (Jefferey Wey) وقمت باستدعائها في عرض (view) الصفحة الرئيسية، وإذا لم تقم بتثبيت هذه الحزمة فلا تكتب هذه الشيفرة.

في النهاية، بعد حفظ كُل من النموذج وملفات الصور، سوف نقوم بإعادة التوجيه نحو صفحة العرض:

return redirect()->route('marketingimage.show', [$marketingImage]);

الآن يمكنك تجربة رفع وحفظ الصور وعمل صورة مصغرة وصورة للهاتف عن طريق زيارة الاستمارة في العنوان التالي:

yourdomain.com/marketingimage/create

يمكنك التأكد من إنشاء الصور من خلال النظر إلى المجلدات حيث يُفترض أن تكون الصور.

سوف ترى أن تابع store يقوم بالكثير من الأشياء، لكن ينقصه آلية للتحقق من الأخطاء، يمكنك فعل هذا لجعل التطبيق أكثر قوة على الرغم من أنني أعتقد أن أمر ليس ضروري.

بما أن Laravel يقوم بوظيفة جيدة عن طريق فصل استمارة التحقق من تابع store، لن يتوقف التابع إذا فشلت عملية التحقق.
حسنا ماذا يمكن أن يفشل أيضا ؟ حسنا ربما تفشل عملية حفظ الملف وهذا يمكن أن يكون بسبب امتلاء النظام، أو بسبب مشاكل في الصلاحيات أو خطأ في كتابة المسارات وأسماء المجلدات.

هذه الأخطاء صعبة الاكتشاف والتصحيح بسبب أنه ربما قد لا تحصل على رسائل الخطأ المناسبة، وعلى أية حال، هذه هي أشهر الأخطاء إذا أردت اكتشافها وتصحيحها.

يمكنك أن ترى أنه على الرغم من أنه لا شيء صعب في إدارة الصورة إلا أن الصعوبة موجودة بشكل ما.

الخطوة المنطقية التالية هي إنشاء تابع show في المتحكم وإنشاء العرض الخاص به.

تابع show

حسنا، هذه هي شيفرة تابع العرض:

public function show($id)
{
   $marketingImage = Marketingimage::findOrFail($id);
   return view('marketingimage.show', compact('marketingImage'));
}

هذه الشيفرة واضحة للغاية، يقوم Laravel باسترجاع مثيل النموذج ثم يقوم بإرجاعه إلى العرض view، لاحظ استخدام findOrFail والتي تقوم بإرجاع ModelNotFoundException، والتي يمكنك التعامل معها من خلال ملف Handler.php في app/Exceptions.

عرض show

حسنا، بعدما انتهينا من التابع ننتقل إلى العرض view:

@extends('layouts.master')

@section('content')
  {!! Breadcrumb::withLinks(['Home'   => '/',
      'marketing images' => '/marketingimage',
      "show $marketingImage->image_name.$marketingImage->image_extension"
   ]) !!}

  <div>
    {{ $marketingImage->image_name }} :  <br>
    <img src="/imgs/marketing/{{ $marketingImage->image_name . '.' .
         $marketingImage->image_extension . '?'. 'time='. time() }}">
  </div>

  <div>
     {{ $marketingImage->image_name }} - thumbnail :  <br>
     <img src="/imgs/marketing/thumbnails/{{ 'thumb-' . $marketingImage->image_name . '.' .
$marketingImage->image_extension . '?'. 'time='. time() }}">
  </div>

  <div>
    {{ $marketingImage->mobile_image_name }} - mobile :  <br>
    <img src="/imgs/marketing/mobile/{{ $marketingImage->mobile_image_name . '.' .
$marketingImage->mobile_extension . '?'. 'time='. time() }}">
  </div>
@endsection

ملاحظة: يمكنك إزالة مساعدات Breadcrumb إذا لم تكن تستخدم تلك الحزمة.

لم نجعل الواجهة الأمامية فاخرة هنا، قمنا فقط بعمل صفحة بسيطة لإظهار الصور. وبما أننا أرسلنا مثيل marketingImage$ إلى المتحكم، فإننا استخدمنا تركيبة blade لاستدعاء اسم الصورة:

{{ $marketingImage->image_name }}

ثم نقوم بإستدعاء الصور الأولية:

 <img src="/imgs/marketing/{{ $marketingImage->image_name . '.' . $marketingImage->image_extension .
'?'. 'time='. time() }}">

سترى أننا استخدمنا تركيبة blade  طباعة اسم الصورة وامتدادها والتي هي مسجلة في قاعد البيانات، وبإبقاء الامتداد في قاعدة البيانات يمكننا استخدام امتدادات مختلفة بدلا من فرض استخدام jpg. على سبيل المثال.

سوف تلاحظ أيضا أننا أضفنا:

'?'. 'time='. time() 

للحصول على متغير، وهذا الأمر سيمنع عملية تخزين المؤقت للصور نظرا لأنه تم إلحاق الوقت في نهاية الرابط. إن التخزين المؤقت للصور يمكن أن يكون مشكلة بالنسبة لإدارة الصور عندما تقوم برفع الصور.

وبالطبع هذا الأمر اختياري ويمكنك تجاوزه.

بقية الشيفرة البرمجية تقريبا نفسها مع بعض التغييرات للصور المصغرة والصور الهواتف. لن تكون الصفحة جميلة جدا، لكنها تقوم بالمهمة.
والآن إذا كان لديك صورة قمت برفعها لحفظها في قاعدة البيانات، يمكنك مشاهدتها عن طريق الذهاب إلى:

yourproject.com/marketingimage/1

يمكنك تغيير الرقم في النهاية لأن هذا الرقم هو رقم الصورة في سجل البيانات.

حسنا، بعد ذلك، قبل أن نعمل على edit و update، لنقم ببناء تابع index في المتحكم ثم عرض (index view).

تابع index

في MarketingImageController، عدل تابع index كما يلي:

public function index()
{
   $images = Marketingimage::all();
   return view('marketingimage.index', compact('images'));
}

يمكنك أن ترى أن الشيفرة سهلة للغاية، فلقد قمنا فقط باسترجاع جميع السجلات إلى كائن images$، والتي يتم تمريرها إلى العرض view عن طريق تابع compact.

عرض Index

بعد ذلك، سنقوم بتعديل views/marketingimages/index.blade.php كما يلي:

@extends('layouts.master')

@section('content')
   {!! Breadcrumb::withLinks(['Home' => '/', 'marketing images' => '/marketingimage']) !!}
   <br>
   <div>
     <div class="panel panel-default">
       <!-- Default panel contents -->
       <div class="panel-heading">List of Marketing Images </div>
       <div class="panel-body">
         <a href="/marketingimage/create"> <button type="button" class="btn btn-lg btn-success">Create New </button> </a>
       </div>

       <!-- Table -->
       <table class="table">
         <tr>
           <th>Id </th>
           <th>Name </th>
           <th>Thumbnail </th>
           <th>Edit </th>
           <th>Delete </th>
         </tr>
       @foreach($images as $image )
         <tr>
           <td>{{ $image->id }}  </td>
           <td>{{ $image->image_name }} </td>
           <td> <a href="/marketingimage/{{ $image->id  }}">
             <img src="/imgs/marketing/thumbnails/{{ 'thumb-'. $image->image_name . '.' .
             $image->image_extension . '?'. 'time='. time() }}"> </a> 
           </td>
           <td><a href="/marketingimage/{{ $image->id }}/edit">
             <span class="glyphicon glyphicon-edit"          
                                 aria-hidden="true"> </span> </a> 
           </td>
           <td>{!! Form::model($image, ['route' => ['marketingimage.destroy', $image->id],                                'method' => 'DELETE']) !!}
                        
            <div class="form-group">
              {!! Form::submit('Delete', array('class'=>'btn btn-danger', 'Onclick' => 'return ConfirmDelete();')) !!}

            </div>
            {!! Form::close() !!} </td>
          </tr>
        @endforeach
      </table>
    </div>
  </div>
@endsection

@section('scripts')
    <script>
       function ConfirmDelete()
       {
           var x = confirm("Are you sure you want to delete?");
           if (x)
               return true;
           else
               return false;
       }
    </script>
@endsection

لقد بدأنا بتوسيع layouts.master ومن ثم قمنا بفتح content كما يلي:

@section('content')

ومن ثم استخدمنا Breadcrumb. (مرة أخرى، إذا كنت لا تستخدم الحزمة فاحذف هذا السطر.)

بعد ذلك قمنا باستخدام شيفرات Bootstrap أساسية، والتي حصلنا عليها من الموقع الرسمي.

وفي النهاية سنجد جدول داخل مُكوّن panel لـ bootstrap بالإضافة إلى زر لإنشاء صورة جديدة، وأزرار أخرى للتعديل والحذف لكل صورة، وستظهر الصور المصغرة لكل صورة في الجدول.

سوف ترى في رأسية مُكوّن panel كيف قمنا بالتعامل مع زر create:

<a href="/marketingimage/create"> 
    <button type="button" class="btn btn-lg btn-success">
        Create New 
    </button> 
</a>

كل شيء واضح، فالجدول ليس معقدا، لكنه تطلب حلقة foreach لطباعة جميع الصفوف (rows):

<!-- Table -->
  <table class="table">
    <tr>
      <th>Id </th>
      <th>Name </th>
      <th>Thumbnail </th>
      <th>Edit </th>
      <th>Delete </th>
    </tr>

@foreach($images as $image )
  <tr>
    <td>{{ $image->id }}  </td>
    <td>{{ $image->image_name }} </td>
    <td> <a href="/marketingimage/{{ $image->id  }}">
      <img src="/imgs/marketing/thumbnails/{{ 'thumb-'. $image->image_name . '.' .
        $image->image_extension . '?'. 'time='. time() }}"> </a>     
    </td>
    <td>  <a href="/marketingimage/{{ $image->id }}/edit">
       <span class="glyphicon glyphicon-edit" aria-hidden="true"> </span> </a> 
    </td>
    <td>{!! Form::model($image, ['route' => ['marketingimage.destroy', $image->id],
                               'method' => 'DELETE'
                 ]) !!}
     <div class="form-group">
       {!! Form::submit('Delete', array('class'=>'btn btn-danger', 'Onclick' => 'return ConfirmDelete();')) !!}

     </div>
       {!! Form::close() !!} 
    </td>
  </tr>
@endforeach
</table>

لا توجد أية صعوبة في الشيفرة، يمكنك أن ترى أنني أضفت مساعدات النموذج form helper حول رابط الحذف delete، وهذا لأسباب أمنية، يجب علينا الحذف باستخدام POST بدل السماح بأن تكون مفتوحة بشكل واسع من خلال استعمال GET.

سوف تلاحظ أيضا أننا قمنا باستخدام التالي:

'Onclick' => 'return ConfirmDelete();'

والتي استخدمناها مع الجافاسكربت لفتح صندوق التأكيد confirm box، حتى لا يقوم المستخدمون بحذف شيء عن طريق الخطأ.
ثم في ('section('scripts@ أضفنا شيفرات جافاسكربت التالية، وكملاحظة سريعة، افترضنا أنه لديك ('yeld('scripts@ في صفحتك الرئيسية (master page)، وإذا لم يكن لديك هذا السطر، يمكنك ببساطة إرفاق الجافاسكربت قبل endsection@ التابعة لـ ('section('content@.

هذه هي شيفرة الجافاسكربت:

 <script>
   function ConfirmDelete()
   {
       var x = confirm("Are you sure you want to delete?");
       if (x)
           return true;
       else
           return false;
   }
 </script>

شيفرة بسيطة للغاية.

والآن، يجب أن تحصل على صفحة index تعمل بدون مشاكل، قم بتجربة ذلك عن طريق الذهاب بمتصفحك إلى:

yourproject.com/marketingimage

نُكمل في الجزء الثالث من الدرس إن شاء الله.

ترجمة -وبتصرّف- للمقال Basic Image Management Part 2 لصاحبه Bill Keck.

حقوق الصورة البارزة: Designed by Freepik.

إدارة الصور هي واحدة من الأشياء التي غالبا ما أجدها صعبة، فأنا معتاد على التعامل مع النماذج وجداول قواعد البيانات، لكن التعامل مع الملفات ليس سهلا بالنسبة لي، فإذا كنت قد بدأت للتو مع Laravel وبدأت تشعر بالصعوبة والضيق، فأنا أشعر بألمك.

لحسن الحظ، أساسيات إدارة الصور في Laravel لن تكون صعبة إذا فهمت بعض الأمور الأساسية.

ملاحظة: إذا كنت جديدا في Laravel، فلا أنصحك بالبدء بهذا الدرس، أنصحك بقراءة بعض الدروس والدورات حول Laravel قبل المتابعة.

سوف تلاحظ أن الدرس طويل لذلك قمت بتقسيمه إلى 3 أجزاء، وسوف تلاحظ أيضا أنني لست بارعا في تصميم الواجهة الأمامية (front-end)، فلذلك فالواجهات التي سنقوم بعملها لن تكون جميلة جدا، يمكنك تزيينها بنفسك لاحقا، فالهدف الأساسي هنا هو تعلم أساسيات إدارة الصور.
لذلك على أية حال، ماهي هذه الأساسيات ؟ فكرتُ بالمتطلبات التي قد تحتاجها في تطبيقك وكتبتها في هذه القائمة:

• إنشاء الصور
• تخزين الصور
• تعديل الصور
• تحديث الصور
• إنشاء صور مصغرة
• تعديل صور مصغرة
• إنشاء وتعديل صور الهواتف بشكل منفصل

بالنسبة للذين اعتادوا على إجراءات المتحكِّمات (controller actions) المريحة، ستظهر الاستمارات عند إجراءات (actions) الإنشاء create والتعديل edit وأما إجراءات التخزين store والتحديث update فوظيفتهم إنشاء وتعديل السجلات والملفات.
سنتعامل مع شيئين مهمين عند تعاملنا مع الصور، الشيء الأول هو النموذج الذي يعمل على البيانات مثل اسم الصورة و مسارها، وأما الشيء الثاني فهو ملف الصورة نفسه الذي سوف يتم تخزينه في مجلد الذي سنقوم بإسناده له.

تثبيت Intervention

سوف نبدأ بتثبيت حزمة Intervention/image، فإذا لم تقُم بذلك، عدل على ملف composer.json وأضف التعليمة التالية في جزء الاستدعاء (require) :

"intervention/image": "~2.2"

ثم أضف السطر التالي ضمن مصفوفة Providers في ملف app\config\app.php (انتبه للفواصل) :

Intervention\Image\ImageServiceProvider::class,

في نفس الملف أضف السطرين التاليين لمصفوفة Aliases:

Intervention\Image\ImageServiceProvider::class,

أنصحك بالإطلاع على صفحة Intervention للتأكد من الإصدار الأخير للحزمة.
في آخر مرة تأكدتُ فيها،كانت تعليمات التَدَخّل تستخدم النمط القديم للإشارة إلى المرجع:

'Intervention\Image\ImageServiceProvider'

يمكنك أن تلاحظ في الأعلى أننا في كلتا الحالتين استخدمنا ::class والتي هي ممارسة جيدة تعلمتها من Laracasts.com، فإذا كنت تستخدم على سبيل المثال PHP Storm، فسيكون باستطاعتك الوصول إلى الفئة class الأساسية.

إن حزمة Intervention تقوم بإعطائنا صياغة (syntax) وطريقة سهلة لصناعة الصور المصغرة بالإضافة إلى الكثير من التوابع (method) الأخرى الرائعة، لذلك سوف نستخدمها في هذا الدرس، ولمزيد من المعلومات حول هذه الحزمة أنصحك بالإطلاع على التوثيق الرسمي.

لاحظ أيضا أننا سنقوم باستخدام حزمة laravelcollective/html وحزمة patricktalmadge/bootstrapper، ولذلك قم بتثبيتهم قبل أن تتابع الدرس.

إنشاء نموذج

سوف نبدأ بإنشاء نموذج Marketingimage، يمكننا فعل ذلك عن طريق artisan من سطر الأوامر بكتابة السطر التالي:

php artisan make:model Marketingimage -m

سوف تلاحظ علم m- الذي سيخبر Laravel أنك تريد إنشاء تهجير migration في نفس الوقت، لذلك فهذه الميزة مفيدة للغاية.

حسنا، قم بتنفيذ الأمر السابق وستحصل على ملف النموذج والمسمى Marketingimage.php مباشرة تحت دليل تطبيقك وستحصل أيضا على ملف التهجير في مجلد database/migrations. دعونا نقوم بتعديل التابع في أعلى ملف التهجير إلى ما يلي:

public function up()
{
    Schema::create('marketing_images', function(Blueprint $table)
    {
        $table->increments('id');
        $table->boolean('is_active')->default(false);
        $table->boolean('is_featured')->default(false);
        $table->string('image_name')->unique();
        $table->string('image_path');
        $table->string('image_extension', 10);
        $table->string('mobile_image_name')->unique();
        $table->string('mobile_image_path');
        $table->string('mobile_extension', 10);
        $table->timestamps();
    });
}

أول شيئ يمكنك رؤيته أنني قد غيرت اسم الجدول، فأنا افضل فصل الكلمات في جدول الأسماء بسطر سفلي underscore. أنت حر في اختيار الطريقة التي تعجبك، لكن يجب أن نختار صيغة الجمع لإتباع قواعد Laravel بشكل صحيح. ففي Laravel، النموذج يكتب بصيغة المفرد وأما اسم الجدول فيكتب بصيغة الجمع.

بعد عمود المعرف الرقمي، قمنا باستخدام عمودين من نوع المنطقي boolean والتي سوف تسمح لنا بمعرفة هل الصورة نشطة أو مميزة، هذه القيود المفيدة سوف تساعد على العمل مع الصور في وقت لاحق.
ثم قمنا بإضافة أعمدة الاسم، المسار والامتدادات للصور وصور الهاتف، وهذا سيسمح لنا بالمرونة الكافية إذا أردت حفظ صورة مختلفة للهاتف، وهذا الأمر ضروري لأن تغيير حجم الصورة قد لا ينتج لنا النتائج المرجوة.

وبما أننا سوف نقوم بإنشاء صور مصغرة من الصور الأصلية، لن نحتاج إلى حفظ أية بيانات لذلك.

عن طريق حفظ مسار وإمتداد الصورة، سيكون لدينا مرجع سهل نستطيع استخدامه لإظهار الصورة في تطبيقنا، بالإضافة إدارة الصورة في قائمة الصور.

عدل على التابع ليبدو على النحو التالي:

public function down()
{
   Schema::drop('marketing_images');
}

بمجرد أن تقوم بذلك، قم بتنفيذ أمر php artisan migrate من سطر الأوامر وتأكد من أن الجدول قد تم إنشاءه.

بعد هذا، سوف نقوم بتعديل نموذج Marketingimage كما يلي:

 <?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Marketingimage extends Model
{
    protected $table = 'marketing_images';

    protected $fillable = ['is_active',
                                     'is_featured',
                                    'image_name',
                                    'image_path',
                                    'image_extension',
                                    'mobile_image_name',
                                    'mobile_image_path',
                                    'mobile_extension'
    ];
}

سوف تلاحظ أننا قمنا بإخبار النموذج الجدول الذي سيتخذه كمرجع، بالإضافة إلى توفير أعمدة مملوءة تلقائيا، حتى لا نواجه مشكلة الإحالة الكتلية mass-assignment.

المتحكم

جيد، نحن الآن مستعدين للاستمرار للخطوة القادمة، سنقوم بإنشاء المتحكِّم بإستخدام artisan:

php artisan make:controller MarketingImageController

وبهذا سوف تحصل على متحكِّم في app/Http/Controllers مع التوابع التالية:

• index
• create
• store
• show
• edit
• update
• destroy

وسوف نستخدم جميع هذه التوابع.
وكنصيحة مفيدة للمبتدئين، قُم بوضع السطر التالي في تابع index:

return 'Here is the index method.';

فهذا سوف يعطيك فرصة لتجربة هذا الطريق route. (يستطيع بقية المبرمجين المحترفين تجاوز هذه الخطوة إذا أرادوا)
وبعد ذلك، سنقوم بتثبيت الطرق routes. عدل على ملف app/Http/routes.php وأضف التعليمة التالية:

Route::resource('marketingimage', 'MarketingImageController');

سوف ترى أننا قد قمنا بإضافة مورد resource، والذي سوف يقوم بإعطائنا الطرق routes لجميع الإجراءات actions بطريقة مريحة للغاية.
حسنا، سوف تستطيع الآن الذهاب إلى yourproject.com/marketingimage وسوف تحصل على النتيجة التالية:

Here is the index method.

الخطوة المنطقية التالية هي إعداد العروض views، أنشئ مجلدا باسم marketingimage أسفل resources/views، ثم أنشئ الملفات الفارغة التالية داخل مجلد marketingimages:

• create.blade.php
• edit.blade.php
• index.blade.php
• show.blade.php

إعداد المجلدات

سوف نعود إلى تلك الملفات في وقت لاحق، في الوقت الحالي، سنقوم بإنشاء مكان لتخزين صورنا الحالية، سوف أجعل هذا الأمر سهلا، أنشئ مجلدا باسم imgs مباشرة تحت مجلدك العام (public folder)، وبداخل مجلد imgs، أنشئ مجلد marketing، وبداخله أنشئ مجلدا باسم mobile وآخر بإسم thumbnails.
الآن قمنا بإنشاء جميع المجلدات للصور.

عرض الإنشاء The Create View

حسنا، دعونا الآن نتعامل مع عرض الإنشاء The Create View. أضف الأسطر التالية داخل ملف `create.blade.php`:

 @extends('layouts.master')
    
    @section('content')
    
        {!! Breadcrumb::withLinks(['Home' => '/', 'marketing images' => '/marketingimage', 'create']) !!}
    
         <h1>Upload a Photo </h1>
    
    
         <hr/>
    
         @if (count($errors) > 0)
    	 <div class="alert alert-danger">
    	 <strong>Whoops! </strong> There were some problems with your input. <br> <br>
    	 <ul>
    	     @foreach ($errors->all() as $error)
    		 <li>{{ $error }} </li>
    	     @endforeach
    
             </ul>
             </div>
    
        @endif
    
    
        {!! Form::open(array('route' => 'marketingimage.store', 'class' => 'form', 'files' => true)) !!}
    
         <!-- image name Form Input -->
         <div class="form-group">
            {!! Form::label('image name', 'Image name:') !!}
            {!! Form::text('image_name', null, ['class' => 'form-control']) !!}
         </div>
    
    
         <!-- mobile_image_name Form Input -->
         <div class="form-group">
            {!! Form::label('mobile_image_name', 'Mobile Image Name:') !!}
            {!! Form::text('mobile_image_name', null, ['class' => 'form-control']) !!}
         </div>
    
    
         <!-- is_something Form Input -->
         <div class="form-group">
            {!! Form::label('is_active', 'Is Active:') !!}
            {!! Form::checkbox('is_active') !!}
         </div>
    
         <!-- is_featured Form Input -->
         <div class="form-group">
            {!! Form::label('is_featured', 'Is Featured:') !!}
            {!! Form::checkbox('is_featured') !!}
         </div>
    
        <!-- form field for file -->
        <div class="form-group">
           {!! Form::label('image', 'Primary Image') !!}
           {!! Form::file('image', null, array('required', 'class'=>'form-control')) !!}
        </div>
    
         <!-- form field for file -->
         <div class="form-group">
            {!! Form::label('mobile_image', 'Mobile Image') !!}
            {!! Form::file('mobile_image', null, array('required', 'class'=>'form-control')) !!}
         </div>
    
         <div class="form-group">
    
            {!! Form::submit('Upload Photo', array('class'=>'btn btn-primary')) !!}
    
         </div>
    
        {!! Form::close() !!}
    
    @endsection

لاحظ أن الشيفرة في الأعلى ليست صعبة ويمكنك فهمها بسهولة دون أن تضطر إلى قراءة الشرح، ولاحظ أيضا أننا نقوم بتوسيع صفحتنا الرئيسية master page، التي بداخلها مجلد المخططات في مجلد العروض. والتي قمنا باستدعائها عن طريق هذه التعليمة:

@extends('layouts.master')

إذا كانت لديك صفحة رئيسية أخرى أو أنها موجودة في مكان مختلف، قم بتعديل ذلك حسب الحاجة، وإذا كنت لا تعرف مفهوم الصفحة الرئيسية master page، قُم بالبحث عن دروس حوله وتعلمه قبل أن تتابع الدرس.
إذا كنت لا تستخدم حزمة `Bootstrapper`، قم بحذف السطر التالي:

{!! Breadcrumb::withLinks(['Home' => '/', 'marketing images' => '/marketingimage', 'create']) !!}

لاحظ أيضا، لهذا الدرس، قمت بتضمين `if` لطباعة أخطاء الإدخال، لكن في العادة، يجب وضع هذا الجزء في جزئية العرض view partial ومن ثم الإشارة إليه بشيء مثل هذا:

@include('errors.errors')

يمكنك أيضا ملاحظة أننا نستخدم مساعد الاستمارة Form helper من حزمة `laravelcollective/html`، فلقد وجدت أن مساعد الاستمارة مفيد جدا خاصة عند استخدامه لفتح الاستمارة:

{!! Form::open(array('route' => 'marketingimage.store', 'class' => 'form', 'files' => true)) !!}

تستطيع أن ترى أننا قمنا بتضمين 'files => 'true والتي تسمح لنا برفع ملفات متعددة.
إذا كنت جديدا في استخدام مساعد الاستمارة، فيمكنك ملاحظة أننا لا نحتاج إلى استخدام POST خاصة وأننا لا نحتاج إلى استدعاء رمز CSFR لأنه يتم ذلك تلقائيا.
ثم لدينا مدخلات المختلفة للاستمارة، لا شيء مجنون للغاية هنا، ولدينا أيضا `Form::submit` والتي نستخدمها كزر، بالإضافة إلى `Form::close()`.
يمكنك أن ترى من مساعد الاستمارة أن الطريق route تم تعيينه إلى `marketingimage.store`، لذلك سوف نعرف من مورد الطريق في `routes.php` أن هذا سوف يأخذنا إلى تابع `store` في `MarketingImageController.php` والذي هو دليل المتحكِّمات.

نُكمل في الجزء الثاني من الدرس.

ترجمة -وبتصرّف- للمقال Basic Image Management Part 1 لصاحبه Bill Keck.

حقوق الصورة البارزة: Designed by Freepik.

حتى الآن تعلمنا كيفية تثبيت وإعداد Laravel، بالإضافة إلى إعداد بعض المشاريع والمهام والموارد المضمّنة و عرضهم على المستخدم، كما أنشأنا وظائف الإنشاء والتعديل والحذف، وفي هذا الفصل سوف نختم الدرس عن طريق إضافة استمارة التحقق.

استمارة التحقق من جانب الخادم

على الرغم من أن استمارات الإنشاء والتعديل تعمل إلا أننا لم نقم بالتحقق من ما يتم إدخاله، وهذا ما سنقوم بعمله اليوم.
هنالك طرق متعددة للتعامل مع استمارة التحقق، بعضها أفضل من الآخر، ولهذا التطبيق الصغير نقترح أن نستخدم وظيفة المتحكِّمات ()validate مع كائن Illuminate\Http\Request مثل هذا، في ملف app/Http/Controllers/ProjectsController.php/:

// /app/Http/Controllers/ProjectsController.php
     
use Illuminate\Http\Request;
     
class ProjectsController extends Controller {
     
    protected $rules = [		'name' => ['required', 'min:3'],		'slug' => ['required'],	]; 
    /**
    * Store a newly created resource in storage.
    *
    * @param \Illuminate\Http\Request $request	 * @return Response
    */


    public function store(Request $request)
    {
    	$this->validate($request, $this->rules); 
    	$input = Input::all();
    	Project::create( $input );
     
    	return Redirect::route('projects.index')->with('message', 'Project created');
    }
     
    /**
    * Update the specified resource in storage.
    *
    * @param  \App\Project $project
    * @param \Illuminate\Http\Request $request	 * @return Response
    */
    public function update(Project $project, Request $request)
    {
    	$this->validate($request, $this->rules); 
    	$input = array_except(Input::all(), '_method');
    	$project->update($input);
     
    	return Redirect::route('projects.show', $project->slug)->with('message', 'Project updated.');
    }

وأما في ملف app/Http/Controllers/TasksController.php/:

// /app/Http/Controllers/TasksController.php
use Illuminate\Http\Request;
     
class TasksController extends Controller {
     
    protected $rules = ['name'        => ['required', 'min:3'],
                        'slug'        => ['required'],	
                        'description' => ['required'],
                       ]; 

   	/**
    * Store a newly created resource in storage.
    *
    * @param  \App\Project $project
    * @param \Illuminate\Http\Request $request	 * @return Response
    */
    public function store(Project $project, Request $request)
    {
    	$this->validate($request, $this->rules); 
    	$input = Input::all();
    	$input['project_id'] = $project->id;
    	Task::create( $input );
     
    	return Redirect::route('projects.show', $project->slug)->with('Task created.');
    }
     
    /**
    * Update the specified resource in storage.
    *
    * @param  \App\Project $project
    * @param  \App\Task    $task
    * @param \Illuminate\Http\Request $request	 * @return Response
    */
    public function update(Project $project, Task $task, Request $request)
    {
    	$this->validate($request, $this->rules); 
    	$input = array_except(Input::all(), '_method');
    	$task->update($input);
     
    	return Redirect::route('projects.tasks.show', 
                               [$project->slug, $task->slug])->with('message', 'Task updated.');
    }

سوف نحتاج أيضا إلى مكان لعرض أية أخطاء، لذلك قُم بفتح  resources/views/app.blade.php/ وأضف السطور التالية أسفل ('yield('content@:

<div class="content">
    @if (Session::has('message'))
    	<div class="flash alert-info">
    		<p>{{ Session::get('message') }}</p>
    	</div>
    @endif

    @if ($errors->any())		
        <div class='flash alert-danger'>
     		@foreach ( $errors->all() as $error )				
                <p>{{ $error }}</p>			
            @endforeach		
        </div>	
    @endif 

   @yield('content')
</div>

إذا أردت قائمة كاملة من قواعد التحقق، أنصحك بزيارة التوثيق الرسمي.
من المفترض أن يعمل كل شيء الآن، وإذا كان عكس ذلك، فسوف تقوم ()this->validate$ بتوجيهك إلى الصفحة الحالية مع الأخطاء التي سوف تظهر على الصفحة.

خاتمة

لقد قمنا في هذه الدورة بتعلم الكثير من الأشياء حول Laravel، مثل كيفية تثبيت وإعداد Laravel 5 بالإضافة إلى بعض المفاهيم المتقدمة مثل الربط بين الطريق والنموذج route model binding والحماية من CSRF، وعلى الرغم من بساطة التطبيق الذي قمنا به إلا أنه بداية جيدة لكل من يريد احتراف Laravel.

ترجمة -وبتصرّف- للمقال Creating a Basic ToDo Application in Laravel 5 – Part 4.

حقوق الصورة البارزة: Designed by Freepik.

حتى الآن تعلمنا كيفية تثبيت وإعداد Laravel، بالإضافة إلى أننا قمنا بـإعداد بعض موارد المشاريع والمهام وعرضهم للمستخدم. في هذا الدرس، سنتعلم كيفية إنشاء وتعديل وحذف الصفحات والإجراءات.

إضافة روابط التصفح

قبل أن نفعل أي شيء، سنقوم بإضافة روابط create/edit/delete/back إلى صفحات المشاريع والمهام:

<!-- /resources/views/projects/index.blade.php -->
@extends('app')

@section('content')
    <h2>Projects</h2>

    @if ( !$projects->count() )
        You have no projects
    @else
        <ul>
            @foreach( $projects as $project )
                <li>
                    {!! Form::open(array('class' => 'form-inline', 'method' => 'DELETE', 'route' => array('projects.destroy', $project->slug))) !!}
                        <a href="{{ route('projects.show', $project->slug) }}">{{ $project->name }}</a>
                        (
                            {!! link_to_route('projects.edit', 'Edit', array($project->slug), array('class' => 'btn btn-info')) !!},
                            {!! Form::submit('Delete', array('class' => 'btn btn-danger')) !!}
                        )
                    {!! Form::close() !!}
                </li>
            @endforeach
        </ul>
    @endif

    <p>
        {!! link_to_route('projects.create', 'Create Project') !!}
    </p>
@endsection

<!-- /resources/views/projects/show.blade.php -->
@extends('app')

@section('content')
    <h2>{{ $project->name }}</h2>

    @if ( !$project->tasks->count() )
        Your project has no tasks.
    @else
        <ul>
            @foreach( $project->tasks as $task )
                <li>
                    {!! Form::open(array('class' => 'form-inline', 'method' => 'DELETE', 'route' => array('projects.tasks.destroy', $project->slug, $task->slug))) !!}
                        <a href="{{ route('projects.tasks.show', [$project->slug, $task->slug]) }}">{{ $task->name }}</a>
                        (
                            {!! link_to_route('projects.tasks.edit', 'Edit', array($project->slug, $task->slug), array('class' => 'btn btn-info')) !!},

                            {!! Form::submit('Delete', array('class' => 'btn btn-danger')) !!}
                        )
                    {!! Form::close() !!}
                </li>
            @endforeach
        </ul>
    @endif

    <p>
        {!! link_to_route('projects.index', 'Back to Projects') !!} |
        {!! link_to_route('projects.tasks.create', 'Create Task', $project->slug) !!}
    </p>
@endsection

هذه الشفرة البرمجية مفهومة، الصعوبة تكمن في رابط الحذف، متحكِّمات الموارد تتطلب إرسال وظيفة HTTP DELETE، وهذا لا يمكن أن يتم مع رابط عادي، لذلك يتطلب نموذج يتم تقديمه إلى طريق route محدد. للمزيد من المعلومات قُم بزيارة إجراءات يتم التحكم بها عن طريق متحكِّمات الموارد.

إنشاء صفحات الإضافة والتعديل

بعد الانتهاء من صفحات عرض قائمة المشاريع، نحتاج إلى إمكانية إضافة وحذف المشاريع والمهام. استمارات الإضافة والحذف ستكون متشابهة كثيرا، لذلك بدلا من تكرارهم، سنقوم بوراثتهم من نموذج واحد.

سوف نبدأ مع عروض create/edit للمشروع:

<!-- /resources/views/projects/create.blade.php -->
@extends('app')

@section('content')
    <h2>Create Project</h2>

    {!! Form::model(new App\Project, ['route' => ['projects.store']]) !!}
        @include('projects/partials/_form', ['submit_text' => 'Create Project'])
    {!! Form::close() !!}
@endsection

<!-- /resources/views/projects/edit.blade.php -->
@extends('app')

@section('content')
    <h2>Edit Project</h2>

    {!! Form::model($project, ['method' => 'PATCH', 'route' => ['projects.update', $project->slug]]) !!}
        @include('projects/partials/_form', ['submit_text' => 'Edit Project'])
    {!! Form::close() !!}
@endsection

قُم بعمل نفس الشيء مع المهام لكن لا تنسَ تحديث الطرق (routes):

<!-- /resources/views/tasks/create.blade.php -->
@extends('app')

@section('content')
    <h2>Create Task for Project "{{ $project->name }}"</h2>

    {!! Form::model(new App\Task, ['route' => ['projects.tasks.store', $project->slug], 'class'=>'']) !!}
        @include('tasks/partials/_form', ['submit_text' => 'Create Task'])
    {!! Form::close() !!}
@endsection

<!-- /resources/views/tasks/edit.blade.php -->
@extends('app')

@section('content')
    <h2>Edit Task "{{ $task->name }}"</h2>

    {!! Form::model($task, ['method' => 'PATCH', 'route' => ['projects.tasks.update', $project->slug, $task->slug]]) !!}
        @include('tasks/partials/_form', ['submit_text' => 'Edit Task'])
    {!! Form::close() !!}
@endsection

الآن توجد عدة مفاهيم جديدة:

إضافة جزئية

الاستمارة تتطلب عدة وسوم، وبدلا من ذلك سنقوم بتقسيمها من جزئية _form ونضعها مباشرة في العرض، استمارة Add هي من نوع POST ترسل البيانات إلى طريق projects.store واستمارة Edit هي من نوع PATCH وترسل البيانات إلى projects.update. قد يبدوا هذا معقدا ومبهم لكن هذه هي الطريقة التي تعمل بها المتحكِّمات.

<form method="POST" action="http://l4todo.localhost.com/projects" accept-charset="UTF-8">
    <input name="_token" type="hidden" value="Y8uOo7SeD5tQZExezDf5a7UwiYR4P6qIHEUKJNxI">
</form>

<!-- /resources/views/projects/partials/_form.blade.php -->
<div class="form-group">
    {!! Form::label('name', 'Name:') !!}
    {!! Form::text('name') !!}
</div>
<div class="form-group">
    {!! Form::label('slug', 'Slug:') !!}
    {!! Form::text('slug') !!}
</div>
<div class="form-group">
    {!! Form::submit($submit_text, ['class'=>'btn primary']) !!}
</div>


<!-- /resources/views/tasks/partials/_form.blade.php -->
<div class="form-group">
    {!! Form::label('name', 'Name:') !!}
    {!! Form::text('name') !!}
</div>

<div class="form-group">
    {!! Form::label('slug', 'Slug:') !!}
    {!! Form::text('slug') !!}
</div>

<div class="form-group">
    {!! Form::label('completed', 'Completed:') !!}
    {!! Form::checkbox('completed') !!}
</div>

<div class="form-group">
    {!! Form::label('description', 'Description:') !!}
    {!! Form::textarea('description') !!}
</div>

<div class="form-group">
    {!! Form::submit($submit_text) !!}
</div>

use Input;
use Redirect;

// ProjectsController
public function store()
{
    $input = Input::all();
    Project::create( $input );

    return Redirect::route('projects.index')
                          ->with('message', 'Project created');
}

public function update(Project $project)
{
    $input = array_except(Input::all(), '_method');
    $project->update($input);

    return Redirect::route('projects.show', $project->slug)
                          ->with('message', 'Project updated.');
}

public function destroy(Project $project)
{
    $project->delete();

    return Redirect::route('projects.index')->with('message', 'Project deleted.');
}

// TasksController
public function store(Project $project)
{
    $input = Input::all();
    $input['project_id'] = $project->id;
    Task::create( $input );

    return Redirect::route('projects.show', $project->slug)
                          ->with('message', 'Task created.');
}

public function update(Project $project, Task $task)
{
    $input = array_except(Input::all(), '_method');
    $task->update($input);

    return Redirect::route('projects.tasks.show', [$project->slug, $task->slug])
                          ->with('message', 'Task updated.');
}

public function destroy(Project $project, Task $task)
{
    $task->delete();

    return Redirect::route('projects.show', $project->slug)->with('message', 'Task deleted.');
}

class Project extends Model {

    protected $guarded = [];


class Task extends Model {

    protected $guarded = [];

...

<div class="content">
    @if (Session::has('message'))       
       <div class="flash alert-info">          
         <p>{{ Session::get('message') }}</p>        
       </div>  
    @endif 
    
    @yield('content')
</div>

...

php artisan migrate:refresh –seed 

بعد أن انتهينا من إعداد قواعد البيانات والطرق (routes)، سوف نتحدث في هذا الجزء عن المتحكِّمات (Controllers)، النماذج (مع العلاقات)، والعروض views. (بما في ذلك نظام blade ومخططات المحتوى).

مساعدات النماذج Form Helpers في Laravel

بعد كل هذه الإعدادات، إذا ذهبنا الآن (في المتصفح) إلى projects/ فسوف نحصل على صفحة فارغة فما هو السبب؟ حسنا، لنكتشف ذلك، قم بتنفيذ الأمر php artisan route:list على سطر الأوامر مرة أخرى وأنظر إلى هذا السطر:

+--------+----------+----------------------------------------+------------------------+-------------------------------------------------+------------+
| Domain | Method   | URI                                    | Name                   | Action                                          | Middleware |
+--------+----------+----------------------------------------+------------------------+-------------------------------------------------+------------+
|        | GET|HEAD | projects                               | projects.index         | App\Http\Controllers\ProjectsController@index   |            |
+--------+----------+----------------------------------------+------------------------+-------------------------------------------------+------------+

يبدو أن رابط projects/ يقوم بتحميل الوظيفة Index الخاصة بـ ProjectsController، لذلك سنقوم بفتح app/Http/controllers/ProjectsController.php/ وسنقوم بتحديث التابع (method) لنقوم بربطه إلى عرض سوف نقوم بإنشائه. قم بإضافة السطر ;('return view('projects.index إلى الوظيفة ()index كالتالي:

public function index()
{
    return view('projects.index');
}

بما أننا نستخدم في هذا الدرس نظام Blade للقَوْلَبة سنقوم بإنشاء ملف resources/views/projects/index.blade.php/ وسنكتب نص قصير داخله، ثم سنقوم مرة أخرى بالذهاب إلى projects/ في المتصفح، إذا كان كل شيء يعمل جيدا فسوف تجد النص الذي كتبته بالأعلى.
والآن قُم بنفس الشيء لتابع المتحكِّم create عن طريق إضافة السطر ;('return view('projects.create إلى التابع ()create كالتالي:

public function create()
{
    return view('projects.create');
}

إن إظهار محتويات العرض view هو أمر رائع، لكن ماذا لو كنا نملك أكثر من صفحة واحدة في موقعنا ؟ في هذه الحالة، سوف نحتاج إلى قالب ثابت لجميع الصفحات، أي أننا نحتاج إلى عرض محتويات العرض view داخل قالب HTML بسيط، وسنقوم بهذا عن طريق مخططات المتحكِّمات.

من أجل عمل مخططات المتحكِّمات سنقوم بالخطوات التالية:

• إنشاء مخطط العرض، وبما أن Laravel توفر لنا واحدة جيدة تدعى app.blade.php لذلك سنوفر الوقت وسنقوم بإستخدامها. لاحظ أن قرب أسفل المخطط هنالك سطر ('@yield('content وهذه دالة ستقوم بتحميل محتوانا الحالي.

• الإشارة إلى مخططك في عرضك view باستخدام ('extends('app@ ولفها عن طريق كتلة ('section('content@، مثل التالي:

  @extends('app')
  
  @section('content')
  
  This is my /resources/views/projects/index.blade.php file!
  @endsection
  

سنقوم الآن بتنفيذ هذه الخطوات بإنشاء عروض show.blade.php و create.blade.php و index.blade.php في مجلد resources/views/projects/ مع الشيفرات (markup) المذكورة أعلاه وقُم بتغيير اسم الملف إذا كان الأمر ضروريا، ثم قُم بعمل تحديث للصفحة projects/ في متصفحك، وسوف ترى هيكل app.blade.php حول محتويات عرضك (view).

الربط بين الطريق (route) والنموذج

سيوفر Laravel بشكل افتراضي معرف رقمي ID للعديد من توابع متحكِّمات الموارد مثل ()show و ()edit و ()update و ()destroy، وهذا الأمر سيضيف العديد من الشيفرات الجاهزة (boilerplate) التي نحتاج إلى كتابتها، مثل الحصول على مثيل النموذج والتأكد من وجودها وغيرها. ولهذا سوف نستخدم إحدى مميزات Laravel والتي تدعى الربط بين الطريق و النموذج route model binding، فبدل من توفير متغير id$، سوف نقوم بإعطاء الوظيفة (method) كائن project$ أو task$.

قُم بفتح app/Http/routes.php/ وأضف هذين السطرين (أول سطرين بعد التعليق):

// Provide controller methods with object instead of ID
Route::model('tasks', 'Task');
Route::model('projects', 'Project'); 

// Use slugs rather than IDs in URLs
Route::bind('tasks', function($value, $route) {
    return App\Task::whereSlug($value)->first();
});

Route::bind('projects', function($value, $route) {
    return App\Project::whereSlug($value)->first();
});

Route::resource('projects', 'ProjectsController');
Route::resource('projects.tasks', 'TasksController');

وفي TasksController و ProjectsController (ملفات app/Http/Controllers/ProjectsController.php/ و app/Http/Controllers/TasksController.php/) قُم باستبدال كل وظيفة (method) مُعرف بمرجع id$ بـ task$ أو project$ مثل التالي:

// public function edit($id)
public function edit(Project $project)

لا تنسَ إضافة use App\Task و use App\Project في أعلى المتحكِّمات حتى نشير إلى هذه النماذج. لا تقلق إذا لم تفهم هذه التغييرات، فسنقوم بعرض الشيفرة البرمجة الكاملة لـ TasksController و ProjectsController لاحقا.
وفي هذه المرحلة يمكنك تمرير الكائن (object) إلى عرضه في كل متحكِّم لوظيفة (method) الإظهار والتعديل والتحديث حتى نستطيع استخدامهم لاحقا:

public function edit(Project $project)
{
    return view('projects.show', compact('project'));
}

سوف يحتاج TasksController إلى بضعة تعديلات طفيفة أخرى، وبما أننا نستخدم الموارد المضمّنة nested resources، سيخبرنا php artisan route:list أن جميع طرق task تحتوي على قناع {projects} بالإضافة إلى أن بعضها يستقبل قناع {tasks} أيضا. و كنتيجة لذلك، سيتم تمرير مثيل Project كمُعامل أول لتوابع المتحكِّمات (controller methods)، لذلك قُم بتحديثها وقٌم بتمرير متغير project$ الجديد.
إذا لم تفهم خطوات الإضافة لـ TasksController و ProjectsController فهذه هي الشيفرة الكاملة للملفين بعد كل التعديلات:

// /app/Http/Controllers/ProjectsController.php
<?php namespace App\Http\Controllers;

use App\Project;
use App\Http\Requests;
use App\Http\Controllers\Controller;

use Illuminate\Http\Request;

class ProjectsController extends Controller {

    /**
     * Display a listing of the resource.
     *
     * @return Response
     */
    public function index()
    {
        $projects = Project::all();
        return view('projects.index', compact('projects'));
    }

    /**
     * Show the form for creating a new resource.
     *
     * @return Response
     */
    public function create()
    {
        return view('projects.create');
    }

    /**
     * Store a newly created resource in storage.
     *
     * @return Response
     */
    public function store()
    {
        //
    }

    /**
     * Display the specified resource.
     *
     * @param  \App\Project $project
     * @return Response
     */
    public function show(Project $project)
    {
        return view('projects.show', compact('project'));
    }

    /**
     * Show the form for editing the specified resource.
     *
     * @param  \App\Project $project
     * @return Response
     */
    public function edit(Project $project)
    {
        return view('projects.edit', compact('project'));
    }

    /**
     * Update the specified resource in storage.
     *
     * @param  \App\Project $project
     * @return Response
     */
    public function update(Project $project)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     *
     * @param  \App\Project $project
     * @return Response
     */
    public function destroy(Project $project)
    {
        //
    }

}


// /app/Http/Controllers/TasksController.php
<?php namespace App\Http\Controllers;

use App\Project;
use App\Task;
use App\Http\Requests;
use App\Http\Controllers\Controller;

use Illuminate\Http\Request;

class TasksController extends Controller {

    /**
     * Display a listing of the resource.
     *
     * @param  \App\Project $project
     * @return Response
     */
    public function index(Project $project)
    {
        return view('tasks.index', compact('project'));
    }

    /**
     * Show the form for creating a new resource.
     *
     * @param  \App\Project $project
     * @return Response
     */
    public function create(Project $project)
    {
        return view('tasks.create', compact('project'));
    }

    /**
     * Store a newly created resource in storage.
     *
     * @param  \App\Project $project
     * @return Response
     */
    public function store(Project $project)
    {
        //
    }

    /**
     * Display the specified resource.
     *
     * @param  \App\Project $project
     * @param  \App\Task    $task
     * @return Response
     */
    public function show(Project $project, Task $task)
    {
        return view('tasks.show', compact('project', 'task'));
    }

    /**
     * Show the form for editing the specified resource.
     *
     * @param  \App\Project $project
     * @param  \App\Task    $task
     * @return Response
     */
    public function edit(Project $project, Task $task)
    {
        return view('tasks.edit', compact('project', 'task'));
    }

    /**
     * Update the specified resource in storage.
     *
     * @param  \App\Project $project
     * @param  \App\Task    $task
     * @return Response
     */
    public function update(Project $project, Task $task)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     *
     * @param  \App\Project $project
     * @param  \App\Task    $task
     * @return Response
     */
    public function destroy(Project $project, Task $task)
    {
        //
    }

}

لاحظ أنه إذا قمت بتحديث صفحة projects/project-1/ سيبقى كل شيء يعمل.

عرض نماذجنا

صفحة عرض قائمة المشاريع، حان الآن وقت البدء بعرض المشاريع والمهام، قٌم بفتح projects/ في متصفحك. وبالاعتماد على php artisan route:list، ستكون هذه الصفحة هي صفحة عرض المشاريع، لذلك قُم بفتح resources/views/projects/index.blade.php/ وأضف التالي:

@extends('app')

@section('content')
    <h2>Projects</h2>
     @if ( !$projects->count() )
        You have no projects
    @else
        <ul>
            @foreach( $projects as $project )
                <li><a href="{{ route('projects.show', $project->slug) }}">{{ $project->name }}</a></li>
            @endforeach
        </ul>
    @endif
@endsection

سوف أشرح بعض النقاط في هذه الشفرة البرمجية:

• استخدمنا في هذه الشفرة لغة Blade للقَوْلَبة، لذلك فإن if و foreach تتحكم في تدفق flow الدوال بإضافة إلى أنها دالة طباعة (الأقواس المعقوفة المزدوجة).
• تأكدنا إن كان هنالك أي مشروع لعرضه، إن كان هنالك أية مشاريع فسيقوم بعرضها وإن لم يكن تظهر رسالة تخبرك بذلك.
• استدعينا مساعد ()route مع طريق ذا اسم (يمكنك رؤية قائمة الطرق ذات الاسم عن طريق php artisan route:list) لربط كل مشروع مع صفحة تفاصيله.

سوف تحتاج أيضا إلى تمرير متغير projects$ لهذا العرض view وإلا ستحصل على خطأ متغير غير معرف undefined variable error. قُم بفتح app/Http/controllers/ProjectsController.php/ وقُم بتحديث الوظيفة ()index إلى:

public function index()
{
    $projects = Project::all(); return view('projects.index', compact('projects'));
}

قُم بتحديث الصفحة (Refresh) وستجد قائمة من مشاريعك.

علاقات النموذج - صفحة تفاصيل المشروع

في صفحة تفاصيل المشروع نحتاج إلى عرض قائمة من مهام المشاريع، وللقيام بذلك نحتاج إلى تعريف علاقة "واحد إلى الكثير one-to-many" في نموذج Project للسماح له بالحصول على المهام tasks.

قُم بفتح app/Project.php/ وأضف التابع ()tasks كالتالي:

public function tasks()
{
    return $this->hasMany('App\Task');
}

بشكل عكسي، يمكننا إضافة علاقة "الكثير إلى واحد many-to-one" لنموذج المهام Task:

public function project()
{
    return $this->belongsTo('App\Project');
}

للتأكد من أنها تعمل اكتب الأمر:

$ php artisan tinker

وستكون النّتيجة كالتي حسب المدخلات:

>App\Project::whereSlug('project-1')->first()->tasks->count();
5
>App\Project::whereSlug('project-2')->first()->tasks->count();
2
>App\Task::first()->project->name;
Project 1

ممتاز، يمكننا الآن تحديث عرض resources/views/projects/show.blade.php/:

@extends('app')

@section('content')
    <h2>{{ $project->name }}</h2>
     @if ( !$project->tasks->count() )
        Your project has no tasks.
    @else
        <ul>
            @foreach( $project->tasks as $task )
                <li><a href="{{ route('projects.tasks.show', [$project->slug, $task->slug]) }}">{{ $task->name }}</a></li>
            @endforeach
        </ul>
    @endif
@endsection

اضغط على أي مشروع في صفحة عرض قائمة المشاريع في متصفحك وسوف يتم عرض المشروع مع جميع المهام المرتبطة به.
وأخير تَبقى لدينا صفحة عرض المهام (resources/views/tasks/show.blade.php/)، وهذه سهلة للغاية:

@extends('app')

@section('content')
    <h2>
        {!! link_to_route('projects.show', $project->name, [$project->slug]) !!} -
        {{ $task->name }}
    </h2>

    {{ $task->description }}
@endsection

ملاحظة: كُن حذرا عندما تستخدم علاقات النماذج (models)، فإنه من السهل إنشاء عدد كبير من استعلامات SQL، وتسمى هذه المشكلة بـ "مشكلة N+1".

الخاتمة

اليوم تعلمنا الكثير من الأشياء الجديدة مثل:

• الربط بين الطريق (route) و النموذج
• النماذج (مع علاقة واحد إلى الكثير one-to-many)
• المتحكِّمات (مع الربط بين الطريق و النموذج)
• العروض (مع لغة blade للقَوْلَبة والمخططات)

أصبحت الصفحة تعرض لنا قائمة من المشاريع والمهام، وفي الدرس القادم سوف نركز على تعديل وإضافة وحذف المشاريع والمهام.

ترجمة -وبتصرّف- للمقال Creating a Basic ToDo Application in Laravel 5 – Part 2.

حقوق الصورة البارزة: Designed by Freepik.

يعتبر Laravel أشهر إطار ويب بلغة PHP، ولقد شهد إصداره الخامس العديد من التغييرات وتمت إضافة الكثير من المميزات الجديدة، ولذلك لتعلم أساسيات هذا الإطار سوف نقوم بإنشاء تطبيق Todo List، وسوف نتعلم من خلال هذا التطبيق الكثير من المفاهيم والطرق البرمجية حتى نتمكن من التعامل والتوسع مع إطار Laravel 5.

ملاحظة: هذا الدرس طويل للغاية لذلك سوف يتم تقسيمه إلى أجزاء أصغر، ويمكنك الحصول على الكود المصدري لكل جزء من GitHub.

في هذا الدرس سوف نتحدث عن تثبيت Laravel 5 وإعداده وعن بعض التقنيات الجديد كالتهجير migration والبذر seeding.

قبل أن نبدأ

أهم المصطلحات التي ستصادفنا في هذه الدروس:
التهجير migration: نظام لإدارة قواعد البيانات، فهو يسمح للفريق بتعديل مخطط قواعد البيانات لجميع الأعضاء.
البذر seeding: يقصد بها إدخال البيانات الأولية لتجربة التطبيق، أي أنه سيقوم بإدخال بيانات لمساعدتك على التطوير واكتشاف الأخطاء.

هدف المشروع

سوف يتكون تطبيقنا من مشروع أو أكثر، كل واحد لديه قائمة مهام خاصة به، وسوف تتمكن من إنشاء وعرض وتعديل وحذف المهام والمشاريع.
في هذا الدرس سوف نقوم بـ:

• إعداد وتنصيب Laravel.
• تركيب حزم إضافية لتسهيل عملية التطوير.
• استخدام التهجير migration والبذر seeds.
• تعلم كيفية استخدام متحكِّمات الموارد resourceful controllers.
• تعلم كيفية استخدام العروض views. (بما في ذلك نظام blade ومخططات المحتوى)
• التعامل مع علاقات النماذج.

التثبيت

إن عملية تثبيت Laravel سهلة للغاية بفضل Composer، لذلك سوف نستخدمه في تثبيته.

استخدام Composer

والآن نقوم بتشغيل مثبت Laravel (سوف تحتاج إلى عمل هذا لمرة واحدة فقط):

composer global require "laravel/installer=~1.1"

والآن نقوم بعمل مشروعنا:

laravel new l5todo

الإعداد

يستخدم Laravel 5 حزمة تدعى DotEnv تقوم بتخزين المعلومات الحساسة في ملفات ذات صيغة .env والتي يتم تحميلها كمتغيرات PHP عند التشغيل. قد يبدوا لك هذا معقدا لكن بكلمات أخرى، هذا يعني أن فقط الإعدادات الحسّاسة credentials يتم تخزينها في هذه الملفات وأما بقية إعداداتك فيتم تخزينها في ملفات الإعداد العادية.

قاعدة البيانات

سوف نحتاج إلى قاعدة بيانات، لذلك سنقوم بعمل واحدة ثم سنقوم بنسخ .env.example إلى .env وتحديث البيانات على الشكل التالي:

DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

في النهاية إذا لم تكن تستخدم MySQL فقُم بفتح config/database.php/ ثم قٌم بتغيير السطر الافتراضي:

'default' => 'mysql',

تذكر أن تضيف ملفات بيئة عملك إلى .gitignore عن طريق إضافة سطر .env.

خطواتنا الأولى

كما ذكرنا في الأعلى، سوف يتكون تطبيق قائمة المهام على مشروع أو أكثر كل واحد مع قائمة المهام الخاصة به، ولذلك سوف نحتاج إلى مشروع، نماذج مهام، متحكِّمات، عروض views، التهجير migration، البذور seeds والطرق routes، ولقد قمنا بشرح بعض هذه المصطلحات في بداية الدرس.
لنبدأ بالتعامل معهم كل واحد على حدة.

التهجير migration

أولا نريد أن نرى مخطط جدولنا، سوف يبدو مثل هذا:

Projects
+------------+------------------+------+-----+
| Field      | Type             | Null | Key |
+------------+------------------+------+-----+
| id         | int(10) unsigned | NO   | PRI |
| name       | varchar(255)     | NO   |     |
| slug       | varchar(255)     | NO   |     |
| created_at | timestamp        | NO   |     |
| updated_at | timestamp        | NO   |     |
+------------+------------------+------+-----+

Tasks
+-------------+------------------+------+-----+
| Field       | Type             | Null | Key |
+-------------+------------------+------+-----+
| id          | int(10) unsigned | NO   | PRI |
| project_id  | int(10) unsigned | NO   | MUL |
| name        | varchar(255)     | NO   |     |
| slug        | varchar(255)     | NO   |     |
| completed   | tinyint(1)       | NO   |     |
| description | text             | NO   |     |
| created_at  | timestamp        | NO   |     |
| updated_at  | timestamp        | NO   |     |
+-------------+------------------+------+-----+

ثم سوف نقوم بعمل التهجير migration:

php artisan make:migration create_projects_and_tasks_tables --create="projects"

سوف نقوم بعمل كِلا الجدولين بتهجير migration واحد حتى نتمكن من حذفها بترتيب عكسي لتجنب سلامة خرق القيد integrity constraint violation، قُم بفتح:

/database/migrations/createprojectsandtasks_tables.php

وقُم بتحديث المعلومات حسب الآتي:

<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateProjectsAndTasksTables extends Migration {

    /**
     * Run the migrations.
     *
     * @return void
     */

    public function up()
    {
        Schema::create('projects', function(Blueprint $table)
        {
            $table->increments('id');
            $table->string('name')->default('');            
            $table->string('slug')->default('');            
            $table->timestamps();
        });

        Schema::create('tasks', function(Blueprint $table) {            
            $table->increments('id');
            $table->integer('project_id')->unsigned()->default(0);
            $table->foreign('project_id')->references('id')->on('projects')->onDelete('cascade');
            $table->string('name')->default('');
            $table->string('slug')->default('');
            $table->boolean('completed')->default(false);
            $table->text('description')->default('');
            $table->timestamps();
       });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */

    public function down()
    {
        Schema::drop('tasks');
        Schema::drop('projects');
    }

}

قم بتنفيذ الهجرة migration:

php artisan migrate

إذا قمت الآن بمراجعة قاعدة البيانات، يجب أن تكون الجداول مكتملة.

البذور Seeds

سوف نحتاج إلى بذر المشاريع/المهام ليكون لديك شيء للعمل معه عندما نصل إلى المتصفح، لذلك قم بإنشاء:

/database/seeds/ProjectsTableSeeder.php و TasksTableSeeder.php 

كالتالي:

// /database/migrations/seeds/ProjectsTableSeeder.php
<?php

use Illuminate\Database\Seeder;

class ProjectsTableSeeder extends Seeder {

    public function run()
    {
        // Uncomment the below to wipe the table clean before populating
        DB::table('projects')->delete();

        $projects = array(
            ['id' => 1, 
             'name' => 'Project 1', 
             'slug' => 'project-1', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],
            ['id' => 2, 
             'name' => 'Project 2', 
             'slug' => 'project-2', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],
            ['id' => 3, 
             'name' => 'Project 3', 
             'slug' => 'project-3', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],
        );

        // Uncomment the below to run the seeder
        DB::table('projects')->insert($projects);
    }

}

// /database/migrations/seeds/TasksTableSeeder.php
<?php

use Illuminate\Database\Seeder;

class TasksTableSeeder extends Seeder {

    public function run()
    {
        // Uncomment the below to wipe the table clean before populating
        DB::table('tasks')->delete();

        $tasks = array(
            ['id' => 1, 
             'name' => 'Task 1', 
             'slug' => 'task-1', 
             'project_id' => 1, 
             'completed' => false, 
             'description' => 'My first task', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],
            
            ['id' => 2, 
             'name' => 'Task 2', 
             'slug' => 'task-2', 
             'project_id' => 1, 
             'completed' => false, 
             'description' => 'My first task', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],

            ['id' => 3, 
             'name' => 'Task 3', 
             'slug' => 'task-3', 
             'project_id' => 1, 
             'completed' => false, 
             'description' => 'My first task', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],

            ['id' => 4, 
             'name' => 'Task 4', 
             'slug' => 'task-4', 
             'project_id' => 1, 
             'completed' => true, 
             'description' => 'My second task', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],

            ['id' => 5, 
             'name' => 'Task 5', 
             'slug' => 'task-5', 
             'project_id' => 1, 
             'completed' => true, 
             'description' => 'My third task', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],

            ['id' => 6, 
             'name' => 'Task 6', 
             'slug' => 'task-6', 
             'project_id' => 2,
             'completed' => true, 
             'description' => 'My fourth task', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],

            ['id' => 7, 
             'name' => 'Task 7', 
             'slug' => 'task-7', 
             'project_id' => 2, 
             'completed' => false, 
             'description' => 'My fifth task', 
             'created_at' => new DateTime, 
             'updated_at' => new DateTime],
        );

        //// Uncomment the below to run the seeder
        DB::table('tasks')->insert($tasks);
    }

}

ولا تنسَ إضافة أصناف البذور(seed classes) إلى database/seeds/DatabaseSeeder.php/ :

use Illuminate\Database\Seeder;
use Illuminate\Database\Eloquent\Model;

class DatabaseSeeder extends Seeder {

    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        Model::unguard();

        $this->call('ProjectsTableSeeder');     
        $this->call('TasksTableSeeder');
    }

}

الآن نقوم بالبذر:

composer dump-autoload

ثم:

php artisan db:seed
# أو
php artisan migrate:refresh --seed

يجب الآن أن تكون قاعدة البيانات قد تم بذرها.

mysql> select * from projects;
+----+-----------+-----------+---------------------+---------------------+
| id | name      | slug      | created_at          | updated_at          |
+----+-----------+-----------+---------------------+---------------------+
|  1 | Project 1 | project-1 | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 |
|  2 | Project 2 | project-2 | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 |
|  3 | Project 3 | project-3 | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 |
+----+-----------+-----------+---------------------+---------------------+
     
mysql> select * from tasks;
+----+------------+--------+--------+-----------+----------------+---------------------+---------------+
| id | project_id | name   | slug   | completed | description    | created_at          | updated_at    |
+----+------------+--------+--------+-----------+----------------+---------------------+---------------+
|  1 |          1 | Task 1 | task-1 |         0 | My first task  | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 
|  2 |          1 | Task 2 | task-2 |         0 | My first task  | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 
|  3 |          1 | Task 3 | task-3 |         0 | My first task  | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 
|  4 |          1 | Task 4 | task-4 |         1 | My second task | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 
|  5 |          1 | Task 5 | task-5 |         1 | My third task  | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 
|  6 |          2 | Task 6 | task-6 |         1 | My fourth task | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 
|  7 |          2 | Task 7 | task-7 |         0 | My fifth task  | 2015-02-05 01:25:43 | 2015-02-05 01:25:43 
+----+------------+--------+--------+-----------+----------------+---------------------+---------------+

النماذج Models

للعمل مع جداول المشاريع والمهام نحتاج إلى نماذج مماثلة، سوف نقوم بإنشائها الآن:

php artisan make:model Project
php artisan make:model Task

كان هذا سهلا

استخدام Artisan – Tinker

الآن لدينا المعلومات في قاعدة البيانات وسيكون من الرائع أن نتعلم حول واحدة من أهم ميزات artisan وهي Tinker الذي يوفر لك سطر أوامر للتعامل مع Laravel، وكمثال، لنستخدمه في معرفة عدد المشاريع في قاعدة البيانات الحالية:

$ php artisan tinker
> App\Project::count();    
3
> App\Task::count();
7

وكما ترى يمكن أن يكون Tinker مفيدا للغاية، لذلك سوف نستخدمه عدة مرات في هذه السّلسلة.

المُتحكِّمات Controllers

الآن وصلنا إلى النقطة التي سوف نبدأ بعرض ما صنعناه على المتصفح، وسوف نحتاج إلى إنشاء بعض المتحكِّمات Controllers والطرق Routes. سنبدأ أولا بالمتحكِّمات:

php artisan make:controller ProjectsController
php artisan make:controller TasksController

الموارد المُضمّنة

نبدأ بإضافة موارد Project و Task إلى app/Http/routes.php/ :

Route::get('/', 'WelcomeController@index');

//Route::get('home', 'HomeController@index');
//
//Route::controllers([
//  'auth' => 'Auth\AuthController',
//  'password' => 'Auth\PasswordController',
//]);

Route::resource('projects', 'ProjectsController');Route::resource('tasks', 'TasksController');

والآن دعونا نرى إحدى مميزات artisan والمُتمثّلة في route:list، في سطر الأوامر أكتب التالي:

php artisan route:list

لتكون النّتيجة

+--------+----------+--------------------------+------------------+-------------------------------------------------+------------+
| Domain | Method   | URI                      | Name             | Action                                          | Middleware |
+--------+----------+--------------------------+------------------+-------------------------------------------------+------------+
|        | GET|HEAD | /                        |                  | App\Http\Controllers\WelcomeController@index    |            |
|        | GET|HEAD | projects                 | projects.index   | App\Http\Controllers\ProjectsController@index   |            |
|        | GET|HEAD | projects/create          | projects.create  | App\Http\Controllers\ProjectsController@create  |            |
|        | POST     | projects                 | projects.store   | App\Http\Controllers\ProjectsController@store   |            |
|        | GET|HEAD | projects/{projects}      | projects.show    | App\Http\Controllers\ProjectsController@show    |            |
|        | GET|HEAD | projects/{projects}/edit | projects.edit    | App\Http\Controllers\ProjectsController@edit    |            |
|        | PUT      | projects/{projects}      | projects.update  | App\Http\Controllers\ProjectsController@update  |            |
|        | PATCH    | projects/{projects}      |                  | App\Http\Controllers\ProjectsController@update  |            |
|        | DELETE   | projects/{projects}      | projects.destroy | App\Http\Controllers\ProjectsController@destroy |            |
|        | GET|HEAD | tasks                    | tasks.index      | App\Http\Controllers\TasksController@index      |            |
|        | GET|HEAD | tasks/create             | tasks.create     | App\Http\Controllers\TasksController@create     |            |
|        | POST     | tasks                    | tasks.store      | App\Http\Controllers\TasksController@store      |            |
|        | GET|HEAD | tasks/{tasks}            | tasks.show       | App\Http\Controllers\TasksController@show       |            |
|        | GET|HEAD | tasks/{tasks}/edit       | tasks.edit       | App\Http\Controllers\TasksController@edit       |            |
|        | PUT      | tasks/{tasks}            | tasks.update     | App\Http\Controllers\TasksController@update     |            |
|        | PATCH    | tasks/{tasks}            |                  | App\Http\Controllers\TasksController@update     |            |
|        | DELETE   | tasks/{tasks}            | tasks.destroy    | App\Http\Controllers\TasksController@destroy    |            |
+--------+----------+--------------------------+------------------+-------------------------------------------------+------------+

ستلاحظ أن كل من projects و tasks هي روابط ذات مستوى عالي، وفي تطبيقنا، المهام تتبع المشاريع، لذلك سيكون من الأفضل للروابط أن تكون مُضمّنة مثل /projects/1/tasks/3 بدلا من /tasks/، وهذا يمكن فعله باستخدام شيء اسمه الموارد المُضمّنة nested resources، وكما هو الحال مع أغلب الأشياء في Laravel، التعديل المطلوب سريع وبسيط، فقط قٌم بفتح /app/Http/routes.php وقٌم بالتعديلات التالية:

// Route::resource('tasks', 'TasksController');
Route::resource('projects.tasks', 'TasksController');

هذا كل شيء، قُم بكتابة php artisan route:list لنعلم ماذا لدينا لحد الآن:

 php artisan route:list
    +--------+----------+----------------------------------------+------------------------+-------------------------------------------------+------------+
    | Domain | Method   | URI                                    | Name                   | Action                                          | Middleware |
    +--------+----------+----------------------------------------+------------------------+-------------------------------------------------+------------+
    |        | GET|HEAD | /                                      |                        | App\Http\Controllers\WelcomeController@index    |            |
    |        | GET|HEAD | projects                               | projects.index         | App\Http\Controllers\ProjectsController@index   |            |
    |        | GET|HEAD | projects/create                        | projects.create        | App\Http\Controllers\ProjectsController@create  |            |
    |        | POST     | projects                               | projects.store         | App\Http\Controllers\ProjectsController@store   |            |
    |        | GET|HEAD | projects/{projects}                    | projects.show          | App\Http\Controllers\ProjectsController@show    |            |
    |        | GET|HEAD | projects/{projects}/edit               | projects.edit          | App\Http\Controllers\ProjectsController@edit    |            |
    |        | PUT      | projects/{projects}                    | projects.update        | App\Http\Controllers\ProjectsController@update  |            |
    |        | PATCH    | projects/{projects}                    |                        | App\Http\Controllers\ProjectsController@update  |            |
    |        | DELETE   | projects/{projects}                    | projects.destroy       | App\Http\Controllers\ProjectsController@destroy |            |
    |        | GET|HEAD | projects/{projects}/tasks              | projects.tasks.index   | App\Http\Controllers\TasksController@index      |            |
    |        | GET|HEAD | projects/{projects}/tasks/create       | projects.tasks.create  | App\Http\Controllers\TasksController@create     |            |
    |        | POST     | projects/{projects}/tasks              | projects.tasks.store   | App\Http\Controllers\TasksController@store      |            |
    |        | GET|HEAD | projects/{projects}/tasks/{tasks}      | projects.tasks.show    | App\Http\Controllers\TasksController@show       |            |
    |        | GET|HEAD | projects/{projects}/tasks/{tasks}/edit | projects.tasks.edit    | App\Http\Controllers\TasksController@edit       |            |
    |        | PUT      | projects/{projects}/tasks/{tasks}      | projects.tasks.update  | App\Http\Controllers\TasksController@update     |            |
    |        | PATCH    | projects/{projects}/tasks/{tasks}      |                        | App\Http\Controllers\TasksController@update     |            |
    |        | DELETE   | projects/{projects}/tasks/{tasks}      | projects.tasks.destroy | App\Http\Controllers\TasksController@destroy    |            |
    +--------+----------+----------------------------------------+------------------------+-------------------------------------------------+------------+

جعل روابط ذات اسم لطيف

الطرق routes الحالية ممتازة لكنها ذات عناوين يمكن تحسينها، مثل هذا العنوان /projects/1/tasks/2، فسيكون من الرائع للزوار أن يتم تغيير المعرف الرقمي ID بالاسم اللطيف للحقول، فمثلا سوف نحصل على /projects/my-first-project/tasks/buy-milk بدلا من /projects/1/tasks/2.

قم بفتح ملف /app/Http/routes.php وضع به التالي:

Route::bind('tasks', function($value, $route) {
    return App\Task::whereSlug($value)->first();
});

Route::bind('projects', function($value, $route) {
    return App\Project::whereSlug($value)->first();
});

هذه الشيفرة سوف تغير السلوك الافتراضي لـ tasks و projects في artisan routes وجعل الروابط ذات إسم لطيف slug.

خاتمة

اليوم لقد قمنا بعمل عدة أشياء وهي:

• تثبيت وإعداد Laravel.
• إضافة موردان اثنان resources.
• إنشاء التهجيرات migrations.
• إضافة بعض بيانات البذور seeds.
• تكوين هيكل الروابط.

بكلمات أخرى، قمنا اليوم بوضع الأساس التي سوف نعتمد عليه في الدروس القادمة من خلال إنشاء جميع العناصر اللازمة حتى تعمل الواجهة الأمامية، ولدينا الآن بعض البيانات في قاعدة البيانات بالإضافة إلى الطرق، في الدرس القادم سوف نبدأ في الواجهة الأمامية للموقع.

هنالك بضعة مواقع أخرى لتحصل على المزيد من المعلومات وآخر الأخبار:

• The Laravel Twitter feed: أخر الأخبار حول تطورات Laravel.
• Taylor Otwell’s Twitter feed: حساب تويتر لمُؤسّس Laravel.
• Laravel.io: لمتابعة آخر الأخبار و الدورات من مختلف مواقع الويب، بالإضافة إلى بودكاست أسبوعي يتحدث عن الأفكار والاهتمامات ذات علاقة إلى المنصة.
• Laravel Packages Registry: مكان جيد لإيجاد أفضل حزم Laravel.
• Code Bright: كتاب إلكتروني مجاني من المؤلف دايلي ريس Dayle Rees.

ترجمة وبتصرف للمقال: Creating a Basic ToDo Application in Laravel 5 – Part 1.

حقوق الصورة البارزة: Designed by Freepik.

يوفر Laravel 5 ميزة جديدة تسمى استعلامات الاستمارة Form Requests تساعد في معالجة بيانات الاستمارة والتحقق من صحتها. ستتعلم في هذا الدرس كيفية إنشاء استمارة اتصال في Laravel 5 باستخدام الميزة المذكورة وإمكانيات Laravel في إرسال البريد الإلكتروني. سنعرض طوال الدرس لميزات وحيل تقنية تتعلق بالتطوير على Laravel.

تتكون استمارة الاتصال من ثلاثة حقول هي اسم المستخدم، وعنوان بريده الإلكتروني والرسالة التي يود إرسالها.

ملحوظة: يفترض الدرس أن Laravel مثبت وجاهز للعمل.

نبدأ بإنشاء مشروع Laravel جديد (أسميته academy) ثم الدخول إلى المجلد:

laravel new academy
cd academy

يمكننا إنشاء متحكِّم Controller خاص بمعالجة استمارة الاتصال وعرضها إلا أننا سندمج هذه الوظيفة - للتسهيل - في المتحكِّم الذي يتولى الأمور الإدارية المتعلقة بالتطبيق. سننشئ لهذا الغرض متحكما باسم AboutController ونستخدم إجراءيْ create وstore لعرض استمارة الاتصال والتعامل معها (يقدم create الاستمارة عبر GET فيما يقدمها store عبر POST). سيستخدم AboutController إجراءات create ،index وstore فقط فسنكتفي بإنشاء متحكِّم بسيط عن طريق أمر artisan make:controller على النحو التالي:

$ php artisan make:controller --plain AboutController

Controller created successfully

نضيف كُنْيتيْن Aliases ضمن ملف app/Http/routes.php لتمكين الوصول إلى الاستمارة عبر المسار contact/:

Route::get('contact', 
  ['as' => 'contact', 'uses' => 'AboutController@create']);
Route::post('contact', 
  ['as' => 'contact_store', 'uses' => 'AboutController@store']);

ينشئ أمر artisan make:controller السابق متحكما خاويا، نتيجة استخدام خيار plain-- مع artisan. أي أنه يتوجب علينا إضافة دالتَيْ create وstore في متحكم AboutController. عدل على المتحكِّم ليبدو على النحو التالي:

<?php

    namespace App\Http\Controllers;

    use Illuminate\Http\Request;

    use App\Http\Requests;
    use App\Http\Controllers\Controller;

    class AboutController extends Controller
    {
        public function create()
        {
          return view('about.contact');
        }
        public function store()
        {
        }
    }

ملحوظة: يوجد المتحكم ضمن المسار app/Http/Controllers الموجود ضمن مجلد المشروع. كل المسارات المذكورة في الدرس تُنسَب إلى مجلد المشروع.

ضبطنا إجراء create ليقدم عرضا View باسم contact.blade.php يوجد ضمن المسار resources/views/about.

العرض contact.blade.php غير موجود لحد الساعة. فلننشئه.

إنشاء استمارة الاتصال

يوفر Laravel ميزات عدة لتصْيِير Rendering استمارات HTML. سنستخدم نظام Blade للقَوْلَبة Templating، المضمن في Laravel، لإنشاء الاستمارة. أنشئ مجلدا باسم about في المسار resources/views/ ثم أنشئ داخله ملفا باسم contact.blade.php. وألصق المحتوى التالي:

<!doctype html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  {!! Html::style('css/form.css') !!}
  <title>Academy Contact</title>
</head>
<body>
    <div id="page-wrap">
        <h1>Academy contact</h1>

        <ul>
            @foreach($errors->all() as $error)
              <li>{{ $error }}</li>
            @endforeach
        </ul>

        <div id="contact-area">
            {!! Form::open(array('route' => 'contact_store', 'class' => 'form')) !!}


            {!! Form::label('Your Name') !!}
            {!! Form::text('name', null, array('required', 'placeholder'=>'Your name')) !!}

            {!! Form::label('Your E-mail Address') !!}
            {!! Form::text('email', null,array('required', 'placeholder'=>'Your e-mail address')) !!}


            {!! Form::label('Message') !!}
            {!! Form::textarea('message', null, array('required', 'id'=>'Message', 'cols'=>'20', 'rows'=>'20','placeholder'=>'Your message')) !!}

            {!! Form::submit('Contact Us!', array('class'=>'submit-button')) !!}

            {!! Form::close() !!}
        
        </div>
    </div>
</body>
</html>

سنعود لشرح هذه الشفرة بعد قليل.

1- تفعيل مكون HTML

في الاستمارة أعلاه استخدمنا مُنشِئ الاستمارات Form builder الموجود في مكون HTML؛ هذا المكون غير مفعل افتراضيا في Laravel 5. لتفعيله نفذ الخطوات التالية.

• عدل على ملف composer.json الموجود في مجلد المشروع وأضف التعليمة التالية ضمن خانة require:

"illuminate/html": "~5.0"

تصبح خانة require على الهيئة التالية بعد إضافة السطر (انتبه للفاصلة , في نهاية السطر الذي يسبق التعليمة التي أضفناها):

"type": "project",
    "require": {
      "php": ">=5.5.9",
      "laravel/framework": "5.1.*",
      "illuminate/html": "~5.0"
    },

• حدث اعتماديات Dependencies المشروع عبر الأمر:

  composer update

   

• بعد انتهاء التحديث عدل على ملف config/app.php وأضف السطر التالي ضمن مصفوفة Providers (انتبه للفواصل):

'Illuminate\Html\HtmlServiceProvider',

في نفس الملف أضف السطرين التاليين لمصفوفة Aliases:

'Form'      => 'Illuminate\Html\FormFacade',
'Html'      => 'Illuminate\Html\HtmlFacade',

2- شرح آلية تصيير الاستمارة

نعود لشرح طريقة إنشاء الاستمارة الموجودة عبر نظام Blade. نبدأ بأول تعليمة:

{!! Html::style('css/form.css') !!}

نطلب من نظام القوالب تحميل ملف CSS لاستخدامه في الصفحة. سيحمَّل ملف CSS في المكان الذي استُدعِيت فيه دالة style التابعة لصنف Html الذي عرَّفناه في الخطوة السابقة ضمن مصفوفة Aliases، هو وصنف Form. انتبه لكتابة اسم الصنف بنفس طريقة تعريفه في المصفوفة (Html وليس HTML). ملف form.css يوجد ضمن مجلد فرعي (باسم css) من مجلد Public. توضع الملفات المتاحة للعموم (مثل CSS وJavaScript) داخل هذا المجلد.

ننتقل للتعليمتين:

{!! Form::open(array('route' => 'contact_store', 'class' => 'form')) !!}
...
{!! Form::close() !!}

تعمل الدالتان Form::open وForm::close() معا من أجل إنشاء وسوم Tags فتح وإغلاق الاستمارة على التوالي. تستقبل دالة Form::open مصفوفة تمثل معطيات إعداد مختلفة؛ مثل كنية route(الوِجهة) التي تشير إلى دالة store ضمن المتحكم AboutController، وclass التي تشير إلى صنف CSS المستخدَم لتنسيق الاستمارة. يُستخدَم إجراء POST افتراضيا إلا أنه يمكن إبداله بGET عبر تمريره في المعطى method على النحو التالي 'method' => 'post'. تضيف دالة Form::open حقلا مخفِيّا عبارة عن رمز _token للحماية من هجمات تزوير الطلب عبر الموقع Cross-site request forgery, CSRF.

ثم يأتي الدور على التعليمات التالية:

<ul>
  @foreach($errors->all() as $error)
    <li>{{ $error }}</li>
  @endforeach
</ul>

تستخدم هذه التعليمات لإظهار رسائل تحقق إذا كانت مُدخَلات المستخدم غير مناسبة لطبيعة الحقول (سنعود لها لاحقا، لا تنسها).

تظهر في ما بعد مجموعة من الدوال من أجل إنشاء حقول الاستمارة: Form::label لإنشاء لصائق Labels الحقول، Form::text لإنشاء حقول نصية، Form::textarea لإنشاء حقول نصية متعددة الأسطر، وForm::submit لإنشاء زر الإرسال. لاحظ أن دالتيْ Form::text وForm::text تحويان معطى باسم خاصية name الخاصة بالحقل (email، name وmessage على التوالي). أضفنا أيضا لكل حقل تشكيلة من الخيارات مثل أسماء أصناف التنسيقات وخصائص HTML.

يمكنك بعد حفظ الملف تنفيذ الأمر التالي (من مجلد المشروع) لتشغيل تشغيل خادوم الويب المضمن في Laravel وتجربة النتيجة:

php artisan serve

أدخل العنوان http://localhost:8000/contact في المتصفح لعرض صفحة الاستمارة.

ننتقل الآن، بعد إنشاء الاستمارة، لإعداد آلية التعامل مع محتوى الاستمارة وتمكين إرسال المقترحات عبرها.

إنشاء استعلام استمارة الاتصال

يضيف الإصدار الخامس من Laravel ميزة جديدة تعرف باستعلامات الاستمارة Form Requests؛ تهدف إلى وضع التصريح Authorization والتحقق من البيانات المرسَلة خارج المتحكِّمات وتغليفها ضمن صنف منفصل. نستخدم artisan لإنشاء استعلام Form request على النحو التالي:

$ php artisan make:request ContactFormRequest

ينشئ الأمر ملفا باسم ContactFormRequest.php مساره app/Http/Requests/ContactFormRequest.php.

يبدو هيكل الصنف، بعد حذف التعليقات، كما يلي:

<?php

namespace App\Http\Requests;

use App\Http\Requests\Request;

class ContactFormRequest extends Request
{
  public function authorize()
  {
    return false;
  }

  public function rules()
  {
     return [
      //
     ];
  }
}

تحدد دالة authorize ما إذا كان يُسمح للمستخدم الحالي بالتفاعل مع الاستمارة. نريد أن يكون أي مستخدم قادرا على التفاعل مع الاستمارة، لذا نعدل الدالة لتكون القيمة المُرجَعة true بدلا من false.

public function authorize()
{
  return true;
}

تعرِّف دالة rules قواعد التحقق المرتبطة بحقول الاستمارة. الحقول الثلاثة، email، name وmessage جميعها مطلوبة (required)؛ كما أن حقل البريد الإلكتروني يجب أن يحوي عنوانا بريديا صالحا. نعدل دالة rules لإدراج هذه القواعد.

public function rules()
{
  return [
    'name' => 'required',
    'email' => 'required|email',
    'message' => 'required',
  ];
}

توجد مدقِّقات Validators أخرى غير required وemail في Laravel للاستخدام عند الحاجة. لاحظ استخدام أكثر من مدقق في نفس الحقل مع الفصل بينها ب| مثل ما فعلنا مع حقل البريد الإلكتروني.

احفظ ملف ContactFormRequest.php ثم افتح المتحكِّم AboutController (الموجود في المسار app/Http/Controllers/AboutController.php) وعدل دالة store لتصبح على النحو التالي: …

use App\Http\Requests\ContactFormRequest;

class AboutController extends Controller {

  public function store(ContactFormRequest $request)
  {

     return \Redirect::route('contact')
           ->with('message', 'Thanks for contacting us!');

  }

}

لا تنس إضافة ;use App\Http\Requests\ContactFormRequest إلى المتحكم ليمكنه استخدام قواعد المصادقة المعرَّفة في الصنف ContactFormRequest.php الذي سيتولى التحقق من موافقة مُدخَلات المستخدم للقواعد الموضوعة ويظهر رسالة خطأ في حال أخلَّ المستخدم بإحداها. على سبيل المثال، إذا أدخل المستخدم عنوانا بريديا غير صالح فستظهر رسالة الخطأ التالية.

طبعا لن تظهر رسائل الخطأ من العدم. تتولى مصفوفة errors$ المستخدمة في ملف contact.blade.php إظهار هذه الرسائل. هل تذكر هذه الشفرة؟

<ul>
@foreach($errors->all() as $error)
  <li>{{ $error }}</li>
@endforeach
</ul>

نعود إلى ContactFormRequest.php. قد ترغب في إظهار رسالة (شكر مثلا) للمستخدم عند نجاح إرسال الاستمارة. تمكن إضافة رسالة سريعة ضمن دالة store. يضاف المتغير المُمرَّر للدالة تلقائيا إلى متغيرات الجلسة Session في Laravel مما يمكّن من استخدامها عبر الدالة Session::get. يمكِن على سبيل المثال استخدام الشفرة التالية لإظهار محتوى المتغير message في أي عرض (View) أثناء الجلسة:

@if(Session::has('message'))
  <div class="alert alert-info">
    {{Session::get('message')}}
  </div>
@endif

بقيت خطوة واحدة لتكون الاستمارة جاهزة لإرسال بريد إلكتروني. نحتاج لإعداد مكوِّن البريد في Laravel وإدماج وظيفة تسليم البريد إلى دالة store.

إعداد مكوِّن البريد في Laravel

يستخدم Laravel حزمة SwiftMailer لتوفير إمكانية إرسال بريد إلكتروني بيسر. كل ما عليك فعله هو ضبط الإعدادات الموجودة في ملف config/mail.php. نذكر في ما يلي بعض الإعدادات الموجودة في الملف.

• driver: يدعم Laravel عدة تعريفات بريد مثل SMTP، دالة بريد PHP (mail)، خادوم بريد Sendmail وخدمتَيْ Mailgun وMandrill لتسليم البريد. يجب أن تضبط الإعدادات على التعريف المرغوب بالاختيار بين mailgun، sendmail، mail،smtp و mandrill. 
• host: تعيين اسم المستضيف لخادوم البريد الإلكتروني (عند استخدام التعريف smtp).
• port: تعيين اسم منفَذ خادوم البريد الإلكتروني (عند استخدام التعريف smtp).
• from: إذا رغبت في أن تستخدم كل الرسائل المرسَلة نفس العنوان البريدي والاسم للمرسِل فبإمكانك ضبط إعدادات from وaddress المعرَّفة في هذه المصفوفة.
• encryption: يحدد بروتوكول التعميّة Encryption المستخدَم لإرسال البريد الإلكتروني.
• username: يعين اسم المستخدم في حال كان التعريف smtp.
• password: كلمة سر المستخدم في حال كان التعريف smtp.
• sendmail: مسار خادوم Sendmail إذا كانت قيمة driver هي sendmail.
• pretend: يطلب هذا الإعداد من Laravl تجاهل التعريف المضبوط وإرسال البريد إلى سجل التطبيق بدلا منه. يناسب التطبيقات التي مازالت قيد التطوير والتجربة.

نأخذ مثالا لإعداد إرسال البريد في Laravel لاستخدام حساب بريد Google. غير الإعدادات التالية مثل ماهو مبيَّن.

• أعط القيمة smtp للتعريف driver. هذه هي القيمة الافتراضية.
• أبدل قيمة host إلى smtp.google.com
• استخدم المنفذ port رقم 465.
• أبدل التعميّة encryption إلى ssl.
• استخدم حساب البريد الإلكتروني ضمن إعداد username.
• اكتب كلمة سر حساب البريد الإلكتروني في إعداد password. تذكر أنه يجب، ضمن بيئة عمل فعلية، حفظ هذه المعلومات ومعلومات أخرى حساسة ضمن ملف env. في مشروعك أو في متغير البيئة في الخادوم.

احفظ التعديلات على ملف config/mail.php ثم عدل المتحكم AboutController ليبدو على النحو التالي:

public function store(ContactFormRequest $request)
{

  \Mail::send('emails.contact',
    array(
      'name' => $request->get('name'),
      'email' => $request->get('email'),
      'user_message' => $request->get('message')
   ), function($message)
   {
     $message->from('wj@wjgilmore.com');
     $message->to('wj@wjgilmore.com', 'Admin')->subject('Academy Feedback');
   });

  return \Redirect::route('contact')->with('message', 'Thanks for contacting us!');

}

الدالة Mail::send هي المسؤولة عن ابتداء عملية تسليم البريد، وتستقبل ثلاثة معطيات. يحدد المعطى الأول اسم العرض (View) المستخدم لقالب جسم (محتوى) البريد الإلكتروني. المعطى الثاني هو مصفوفة بالبيانات المتاحة للاستخدام في جسم البريد الإلكتروني. البيانات المتاحة في حالتنا هي تلك القادمة من استمارة الاتصال عبر الكائن request$. يمنح المعطى الثالث إمكانية تحديد خيارات إضافية للبريد الإلكتروني مثل المرسِل، المستقبِل والموضوع.

سنحتاج لإنشاء العرض الذي توجد به محتويات البريد. لذا سننشئ ملفا باسم contact.blade.php في المسار resources/views/emails. طبعا يمكنك تغيير اسم ومجلد العرض؛ إن فعلت فلا تنس التعديل على المتحكم AboutController بما يوافقك تغييراتك.

You received a message from academy.hsoub.com:

<p>
  Name: {{ $name }}
</p>

<p>
  {{ $email }}
</p>

<p>
  {{ $user_message }}
</p>

ملحوظة: يوجد سجل التطبيق في المسار storage/logs/laravel.log. عند إعطاء القيمة true لpretend ستحاكي إرسال بريد دون أن ترسله فعليا وسيظهر سطر يشبه التالي في السجل:

[2015-07-12 11:34:51] local.INFO: Pretending to mail message to: wj@wjgilmore.com

عُد، بعد حفظ التعديلات، إلى استمارة الاتصال؛ اكتب بيانات صحيحة ضمن حقول الاستمارة وأرسلها. يجب أن تصل الرسالة إلى البريد الموجود في دالة to (أي wj@wjgilmore.com في المثال).

قد تواجه مشاكل مع إعدادات Gmail بسبب التقييدات على تطبيقات الطرف الثالث في Gmail. راجع إعدادات حساب Google في هذه الحالة.

خاتمة

اخترنا عرض جميع المخرجات المذكورة في هذا الدرس باللغة الإنجليزية للتركيز على الخاصية المشروحة. إن أردت توطين Localization المثال واستخدام اللغة العربية فيمكنك كتابة العبارات العربية مباشرة في ملفات القوالب لكن ستبقى رسائل الخطأ باللغة الإنجليزية ويجب عليك إدراج رسائل خطأ خاصة بالعربية.

على العموم يُنصَح، لمن أراد توفير قابلية التوطين بسهولة، بعدم كتابة المُخرجات مباشرة في الشفرة Hard code بل إنشاء ملف بسلاسل المحارف Strings المستخدمة واستدعاء ملف اللغة المناسبة عن طريق دالة الترجمة trans. يُنشَأ مجلد لكل لغة مدعومة ضمن المسار resources/lang الذي يوجد فيه افتراضيا مجلد للغة الإنجليزية en به ملفات بالعبارات المستخدمة افتراضيا.

ترجمة بتصرف لمقال Creating a Contact Form in Laravel 5 Using the Form Request Feature لصاحبه Jason Gilmore

تخيّل معي الوضع التالي. أنت عضو في فريق تطوير تطبيق باستخدام Laravel 4. يستخدم أعضاء الفريق git لإدارة إصدارات التطبيق وفي كل مرة يقوم عضو من أعضاء الفريق بإضافة خصائص أو إدخال تعديلات جديدة على المشروع يقوم بإيداع التغييرات في مُستودع التطبيق. إلى هنا يبدو الوضع عاديا (بل مثاليا) لكن ماذا لو قام أحد أعضاء الفريق بإدخال تعديل يتطلب إضافة جداول جديدة إلى قاعدة البيانات أو تعديل حقول وحذف أخرى، فما الحل هنا؟ هل يستطيع git مثلا أن يفي بالغرض؟ أم أنه سيتم تصدير قاعدة البيانات في كل مرة ويُطلب من كل عضو في الفريق استيرادها؟ ماذا عن البيانات التي تحتويها قاعدة البيانات؟ وهل يجب فعلا أن نتخلص من قاعدة البيانات القديمة واستبدالها بأخرى في كل مرة؟

إن كنت تستخدم إطار عمل لارافل فالحل يكمن في استخدام التهجير migrations والذي يُعتبر نظاما لإدارة الإصدارات الخاصة بقواعد البيانات، حيث أنه لن تعود هناك حاجة إلى إنشاء أي جداول أو إضافة حقول والتعديل عليها بشكل مُباشر/يدوي، وإنما يتم وصف تلك الجداول وحقولها بصيغة تجعل من التعامل مع قواعد البيانات أسهل.
قد يبدو الأمر مُعقّدا بعض الشيء، لكنه في حقيقة الأمر بسيط، وبمُجرد أن تفهم آلية عمله وتشرع في استخدامه حتى تستغرب كيف ضيعت كل الوقت السابق في إدارة قواعد البيانات يدويا. خاصية migrations مُفيدة لك حتى ولو كنت تعمل على مشروعك بشكل فردي.

بطبيعة الحال ستحتاج إلى إنشاء قاعدة بيانات للمشروع، ومن ثم التعديل على ملف app/config/database.php بما يتوافق مع ذلك.

إنشاء ملفات migrations

لإنشاء ملف migration جديد نحتاج إلى استخدام artisan لتنفيذ الأمر migration:make على النحو التالي مع استبدال اسم عملية التهجير بما يتوافق مع ما تقوم به (بطبيعة الحال ستحتاج إلى تنفيذ هذا الأمر بسطر الأوامر لما تكون داخل مُجلد المشروع):

php artisan migrate:make create_users_table

سيقوم laravel بإنشاء ملف جديد داخل مُجلد app/database/migrations يحمل الاسم الذي حددته في الأمر السابق ( create_users_table) مسبوقا بترقيم يُمثل تاريخ إنشائه حتى يتسنى لـ laravel معرفة الترتيب الذي يجب اتباعه لدى تنفيذ التهجيرات.
يُفضل استخدام أسماء للتهجيرات تدل على ما تقوم به. ففي المثال السابق أردنا إنشاء عملية تهجير جديدة لإنشاء جدول مُستخدمين، وبالتالي كان الاسم create_users_table.
ينتج عن تنفيذ الأمر السابق ملف يحتوي:

<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateUsersTable extends Migration {

/**
* Run the migrations.
*
* @return void
*/
public function up()
{
//
}

/**
* Reverse the migrations.
*
* @return void
*/
public function down()
{
//
}

}

كما هو ظاهر هنا فإن الصنف CreateUsersTable يحتوي على دالتين الأولى up والتي تُبين ما الذي يجب القيام به لدى تنفيذ التهجير، والثانية down والتي نُحدد فيها ما الذي يجب القيام به لدى إلغاء التهجير في حال ما إذا أردنا العودة بقاعدة البيانات إلى الحالة التي كانت عليها قبل تنفيذ التهجير.

هذا الملف لا يُحدد أي جدول نعمل عليه أو نرغب في إنشاءه. يُمكن إضافة ذلك يدويا، كما أنه يُمكن القيام بذلك عبر تحديد اسم الجدول لدى تنفيذ أمر إنشاء عملية التهجير وذلك باستخدام --create التي تُحدد اسم الجدول الذي نرغب في إنشاءه أو --table التي تُحدد اسم الجدول الذي نرغب في التعديل عليه. فمثلا لو حذفنا عملية التهجير السابقة ورغبنا في إعادة إنشاء أخرى مع تحديد اسم الجدول فسيكون ذلك على النحو التالي:

php artisan migrate:make create_users_table --create=users

والذي سينتج عنه ملف مثل الملف السابق، لكن هذه المرة نجد أن دالتي up و down تحتويان أوامر أولية:

<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateUsersTable extends Migration {

   /**
   * Run the migrations.
   *
   * @return void
   */
   public function up()
   {
   Schema::create('user', function(Blueprint $table)
   {
      $table->increments('id');
      $table->timestamps();
     });
   }

   /**
   * Reverse the migrations.
   *
   * @return void
   */
   public function down()
   {
      Schema::drop('user');
   }

}

لاحظ هنا أن users هي اسم الجدول المُراد إنشاؤه والذي يكون عادة جمع اسم الـ model الذي تتعامل معه (بمعنى إن كان  user هو اسم الـ model فسيكون اسم الجدول الخاص به users)

أما لو أردنا التعديل على نفس الجدول السابق وإضافة حقل جديد إليه فيكفي تنفيذ الأمر التالي:

php artisan migrate:make add_votes_to_user_table --table=users

 تنفيذ عمليات التهجير

إلى حد الآن كل ما قمنا به هو إنشاء ملفات التهجير، حيث أنك لو تحققت من قاعدة البيانات لوجدتها فارغة. لتنفيذ عمليات التهجير نستعمل الأمر

php artisan migrate

وبعد ذلك ستلاحظ ظهور جدول جديد على قاعدة البيانات.
أما لو رغبت في التراجع عن آخر عملية تهجير (أو بالأحرى عن آخر جملة تهجيرات تم تنفيذها مع بعض) فإننا نستعمل الأمر:

php artisan migrate:rollback

وفي حال ما إذا رغبت في التراجع عن جميع عمليات التهجير والرجوع إلى الحالة الأولى لقاعدة البيانات فإن الأمر التالي كفيل بالقيام بذلك:

php artisan migrate:reset

ويُمكن أيضا استخدام الأمر التالي للتخلص من جميع عمليات التهجير وإعادة تنفيذها من جديد بشكل مُباشر بعد ذلك:

php artisan migrate:refresh

أنواع الحقول

رأينا في الفقرة السابقة بأن عمليات التهجير تسمح لنا بإنشاء معرف autoincrement إضافة إلى حقلي created_at و updated_at بفضل دالة timestamps. يسمح Laravel بإنشاء شتى أنواع الحقول التي قد تحتاجها في مشروعك إلى جانب إضافة خصائص للحقول وإعطائها قِيمًا أوليّة. المثال التالي يُبين بعض هذه الحقول والخصائص:

$user->string('name', 64);
$user->integer('age')->nullable();
$user->boolean('active')->default(1);
$user->integer('role_id')->unsigned();
$user->text('bio');

والذي يقوم  بإنشاء:

• حقل name يكون نصيا يكون أقصر من أو يُساوي 64 محرفا.
• حقل age يكون رقميا، كما أنه يقبل القيمة NULL
• حقل active يكون منطقيا ويحمل قيمة أولية 1
• حقل role_id رقميا ويكون موجبا
• حقل bio يكون نصيا

بإمكان الاطلاع على جميع أنواع الحقول المُمكنة من هنا

حذف الحقول

ستحتاج إلى حذف الحقول في دالة down ويتم ذلك على النحو التالي:

Schema::table('users', function($table)
{
   $table->dropColumn('votes');
});

بذر قواعد البيانات database seeding

المقصود ببذر قواعد البيانات هو إدخال البيانات الأولية التي نحتاجها لتجربة التطبيق. بالرغم من أن تطبيقك يسمح بإنشاء مُستخدمين جدد فإنك سترغب في استخدام مُستخدمين تجريبيين في كل مرة تُحدث تغييرات في التطبيق، وإنشاء عدد من المُستخدمين يدويا في كل مرة مضيعة للوقت. الحل يكمن في إعلام Laravel بالبيانات الأولية التي ترغب في بذر قاعدة البيانات بها بعد إنشائها ويتم ذلك عبر إنشاء ملفات بذر داخل مُجلد app/database/seeds يحتوي الأوامر التي يجب تنفيذها.
مثال على ملف بذر يقوم بإضافة مُستخدم جديد:

class UserTableSeeder extends Seeder {

   public function run()
   {
      DB::table('users')->delete();
      User::create(array('email' => 'foo@bar.com'));
   }

}

لتنفيذ عملية البذر التي قمنا بإنشائها فإننا نستخدم الأمر التالي:

php artisan db:seed --class=UserTableSeeder

وإن كان لديك أكثر من ملف بذر وترغب في تنفيذها كاملة بأمر واحد فإنه يكفي القيام بذلك عبر تحديد أسماء عمليات البذر المُراد تنفيذها في صنف/ملف DatabaseSeeder الذي ستجده داخل مُجلد app/database/seeds على النحو التالي:

class DatabaseSeeder extends Seeder {

   public function run()
   {
      $this->call('UserTableSeeder');
      $this->call('PostTableSeeder');
   }
}

وبعد ستحتاج إلى تنفيذ الأمر

php artisan db:seed

الذي سيقوم بقراءة الملف واستدعاء عمليات البذر بشكل مُتوال
بإمكانك أيضا تنفيذ عمليات البذر مُباشرة بعد تحديث عمليات التهجير على الشكل التالي:

php artisan migrate:refresh --seed

توليد بيانات تجريبية باستخدام Faker

بالرغم من أن هذه الخُطوة ليست ضرورية، إلا أنه في الكثير من الحالات ستحتاج إلى بيانات تجريبية أقرب ما تكون إلى البيانات الحقيقية للتجريب عليها. فمثلا سترغب في استخدام أسماء مُستخدمين "حقيقيين" وعناوين بريد إلكتروني، وعناوين منازل، إضافة إلى أسماء المُدن وأرقام هواتف وما إلى ذلك. بطبيعة الحال فإنه بالإمكان الاكتفاء بملفات البذر وإدخال تلك البيانات بطريقة شبه يدوية، إلا أن هناك حلا آخر يُسهّل عليك ذلك إن استعنت بمكتبة Faker للحصول على هذه البيانات.
بداية سنحتاج إلى "تنصيب" Faker وذلك على النحو التالي:
قم بالتعديل على ملف composer.json وإضافة التالي:

"require-dev":{
"fzaninotto/faker": "1.5.*@dev"
},

أو قم بإضافة "fzaninotto/faker": "1.5.*@dev" إن كان حقل require-dev مُتوفرا في الملف.
بعدها قم بتنفيذ الأمر php artisan update ليقوم artisan بتحميل الملفات المطلوبة.
في غالب الأحوال ستحتاج إلى إنشاء مُستخدم غير عشوائي إلى جانب البيانات التجريبية، وعليه يُفضل إنشاؤه أولا قبل توليد البيانات العشوائية.

$user = User::create(array(
   'username' => 'djug',
   'first_name' => 'Youghourta',
   'last_name' => 'Benali',
   'email' => 'djug@someNewProject.com',
   'password' => Hash::make('MySuperPassword')
));

$faker = Faker\Factory::create();

for ($i = 0; $i < 25; $i++)
{
   $user = User::create(array(
   'username' => $faker->userName,
   'first_name' => $faker->firstName,
   'last_name' => $faker->lastName,
   'email' => $faker->email,
   'password' => Hash::make('Password')
));

في هذا المثال قمنا بإنشاء 25 مُستخدم يحملون أسماء بشر (وليس مُجرد حروف عشوائية) إضافة إلى عناوين بريد إلكتروني.

تسمح مكتبة Faker بتوليد شتى أنواع الحقول التي قد تحتاجها والتي يُمكن الحصول على نُسخ مُوطنة ومُترجمة منها، فمثلا يُمكن توليد أسماء عربية وعناوين فرنسية وما إلى ذلك.
للمزيد حول مكتبة Faker قم بإلقاء نظرة على مُستودع المشروع على github
وللمزيد حول جميع أنواع العمليات التي يُمكن القيام بها على الهجرات: Schema Builder