دستورات اولیه و مهم لاراول

در این مقاله قصد دارم دستورات مهم و کاربردی که در محیط ترمینال و controller , route و Model کاربرد دارند و معمولا باید بدونیم رو بنویسم که به صورت یک مطلب روی وبلاگم داشته باشم.

( لاراول ۵.۴ )

۱ – رفع باگ migration در لاراول ۵.۴

وقتی لاراول رو نصب میکنیم و فیلدهای دیتابیس رو از طریق migration ایجاد میکنیم، بعد از اینکه migrate کنیم با خطایی روبرو میشیم که تصویر خطا رو به صورت زیر میبینیم :

که برای رفع این مشکل در فایل AppServiceProvider.php در مسیر app > providers کد زیر را اضافه می کنیم :

public function boot()
{
Schema::defaultStringLength(191);
}

۲ – نمایش لیست Route های موجود پروژه در ترمینال

برای نمایش لیست Route های موجود در پروژه و جزئیات آنها از دستور زیر در ترمینال استفاده میکنیم

php artisan route:list

۳ –  اعتبارسنجی فرم ها و ایجاد Request

برای اعتبارسنجی فرم ها هم میتوان بعد از ارسال مقدار فیلدها، داخل متد کنترلر اعتبارسنجی رو انجام داد و هم اینکه با استفاده از محیط ترمینال یک Request برای فرم مورد نظر ایجاد کرد و اعتبارسنجی همه فرم های پروژه رو داخل فایلهای مربوط به هر فرم ایجاد نمود. برای ایجاد Request داخل ترمینال دستور زیر را وارد میکنیم :

php artisan make:request ArticleValidate

بعد از اینکار وارد فولدر Http > Request میشیم و فایل ArticleValidate را میبینیم که میتوانیم موارد مربوط به اعتبارسنجی را داخل آن وارد کنیم، اولین کار اینه که متد authorize() را از حالت false به true تغییر دهیم و سپس داخل متد rules() اعتبارسنجی را انجام دهیم.

    public function rules()
    {
        return [
            'ArticleTitle'      => 'required',
            'MetaDescriptions'  => 'required',
            'body'              => 'required'
        ];
    }

بعد از نوشتن فیلدهایی که باید اعتبار سنجی شوند باید داخل متد کنترلر که فرم به آن ارسال میشود نام این request را به عنوان آرگومان ورودی ارسال کنیم.

  public function saveArticle(ArticleValidate $request){
 //....
 }

که برای نمایش Error ها، داخل فایلی که فرم ارسال میشود میتوان آنها را نمایش داد.

۴ – فارسی سازی خطاهای نمایش داده شده به کاربر

برای فارسی سازی خطاهایی که مثلا هنگام ارسال فرم نمایش داده میشود، وارد فولدر resource > lang میشیم، در این فولدر یک فولدر به نام en وجود دارد که یک کپی از آن میگیریم و به fa تغییرش میدیم و وارد فایلهای فولدر میشیم و به فارسی تغییر میدیم ( البته فایل فارسی شده آن توسط بقیه دوستان برای دانلود روی گیت هاب وجود داره ) سپس وارد فولدر config و فایل app.php میشیم و کد ‘locale’ => ‘en’  را به ‘locale’ => ‘fa’ تغییر می دهیم.

دانلود فایل فارسی شده

۵ – تغییر مکان قرارگیری فایلهای مدل و کنترلر و مرتب سازی آنها

وقتی پروژه خود را با لاراول استارت میزنید، به صورت اتوماتیک یکسری از کنترلرها و مدلها ساخته میشود، من شخصا برای پروژه دوست دارم که فایلهای کنترلر و مدل را تفکیک کنم مثلا همه مدل ها را داخل فولدری به نام Models قرار دهم که با اینکار باید namespace و مسیر دسترسی به مدل را داخل کنترلر ادیت کنم. همچنین مدل User.php را نیز به فولدر Models انتقال میدم که با خطای زیر مواجه میشم :

برای رفع این خطا و دسترسی کنترلر به مدل وارد فایل config/auth.php میشم و مسیر دسترسی به مدل را ویرایش میکنم :

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],

همچنین داخل مدل User قسمت namespace را نیز به App\Models تغییر میدم.

۶ –  رفع خطای Mass Assignment در لاراول

وقتی میخواهیم با استفاده از متدهایی همچون create مقاله ای ، …  را اضافه کنیم و نیاز داریم که فیلدهای دیتابیس را تغییر دهیم با اجرای متد با خطایی به نام Mass Assignment روبرو میشیم که اجازه تغییر فیلدها دیتابیس را به کاربر نمیده، برای اینکار در فایل مدل مربوطه باید مشخص کنیم که کاربر اجازه تغییر کدام یک از فیلدها را خواهد داشت، که برای اینکار مثلا برای مقالات ما اگر بخواهیم فقط اجازه تغییر مقادیر تایتل و متن توضیحات رو به کاربر بدیم به صورت زیر اقدام میکنیم :

    protected $fillable = ['title' , 'body' ];

و اگر بخواهیم به همه فیلدها به جز یک فیلد یا تعداد کمتری اجازه تغییر دهیم، به جای ذکر همه فیلدها با استفاده از متد فوق میتوان به صورت زیر عمل کرد : ( اگر به همه فیلدها اجازه تغییر دهیم برای حالت زیر یک آرایه خالی قرار میدهیم )

  protected $guarded = ['price'];

۷ – رفع مشکل composer autoload

گاهی وقت ها مجبور میشیم که فایل کنترلر را حذف و مجددا بسازیم که در این حالت به دلیل باقی ماندن فایل در دایرکتوری composer با خطای زیر مواجه میشیم :

با اجرای کد زیر در ترمینال میتوان مشکل مورد نظر را حل و کنترلر را ایجاد کرد.

composer dumpautoload

۸ – ایجاد بخش لاگین و ثبت نام کاربر

php artisan make:auth

با استفاده از دستور فوق بخش های مربوط به لاگین و ثبت نام کاربران در پروژه لاراولی ایجاد میشود. ( مانند route ها و view ها )