عیب یابی خطاهای رایج در لاراول

لاراول ، یک چارچوب جامع و کاربردی از PHP است که به دلیل ظرافت و استحکام مورد استفاده بسیاری از علاقه مندان به کدنویسی قرار گرفته است، اما هرگز نباید از این موضوع غافل شد که خطاها بخشی از روند توسعه می باشد. بنابراین در این عنوان تصمیم داریم تا جامع ترین مراحل رمز گشایی از خطاهای رایج در لاراول را با شما به اشتراک بگذاریم و سریع ترین راه حل های عملی این ایرادات را در کنار یکدیگر بررسی کنیم.

عیب یابی رایج ترین خطاها در Laravel

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

• خطاهای Server
• خطاهای Database
• خطاهای Syntax
• خطاهای Route

1- بررسی خطاهای رایج سرور در لاراول

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

• خطا 403

این خطا نمایش یک ایراد در مجوزات است که بیانگر درک درخواست اما عدم امکان صدور مجور برای این درخواست خاص می باشد و به دلیل مجوزهای نادرست فایل، مشکلات احراز هویت، یا تنظیمات کنترل دسترسی در فرم ورک Laravel  اتفاق می افتد. برای حل این مسئله می توانید از تایید مجوزهای فایل و دایرکتوری، Ensure correct authentication logic و کنترل دسترسی با تنظیمات Path و Middleware کمک بگیرید.

• خطا 500

خطا 503 یکی از ترسناک ترین خطاها برای توسعه دهندگان لاراول است. در واقع خطا 500 یک کد وضعیت عمومی برای HTTP است و اغلب ناشی از مشکلات Server-Side مانند پیکربندی نادرست، خطاهای Syntax در کد یا استثنائات کنترل نشده می باشد. به عبارت دیگر وضعیت غیرمنتظره ای را نشان می دهد که سرور با آن مواجه شده و سعی دارد تا از انجام دادن این درخواست جلوگیری نماید. برای پیشگیری از این اتفاق می توانید از نوشتن کدهای حساس در بلوک های Try-Catch استفاده کنید.

• خطا 503

به طور معمول اگر این خطا را مشاهده کردید باید دریافت که سرور به طور موقت در دسترس نیست و این مورد اغلب به دلیل تعمیر و نگهداری یا اضافه بار، کاربرد در حالت تعمیر و نگهداری، منابع سرور ناکافی و یا قطع موقت سرویس اتفاق می افتد. برای رفع این موضوع می توانید بررسی کنید که آیا php artisan down رخ داده و یا هشدارهای منابع سرور و مشکلات قطع سرویس دریافت کرده اید یا خیر؟

• خطا 504

اگر API های خارجی کند شده و یا وقفه های زمانی نسبتاً زیادی در دیتابیس رخ دهد، ممکن است خطای نمایش داده شده خطایی از نوع 504 باشد. همچنن لازم به یادآوریی است که مشکلاتی مانند پیکربندی سرور نیز موجب بروز این ایراد فنی خواهد بود. پس زمانی که با دیدن این خطا دریافتید که انتظار برای پاسخگویی سرور دیگر به پایان رسیده، باید API callها را بهینه کرده و به فکر افزایش تنظیمات زمان‌بندی در پیکربندی سرور بیفتید.

2- بررسی خطا رایج دیتابیس در لاراول

دسته دوم از خطاهایی که در لاراول به طور رایج اتفاق می افتد مربوط به دیتابیس است که با نمادی به شکل PDOE xception برای کاربران لاراول نمایان می گردد. در حالتی که با این خطا مواجه شدید باید مواردی مانند Database host ،Username ،Password و Port را که در فایل env قرار گرفته است را مجدد بررسی نمایید. علاوه بر آن باید بررسی کنید که پسوند دیتابیس ها مانند PHP-Mysql در قسمت پیکربندی PHP سرور شما نصب شده و به فعالیت خود ادامه دهد. برای مشاهده نصب شدن و یا نشدن این مورد می توانید از ترفند ایجاد یک صفحه PHPinfo برای تنظیمات PHP، وضعیت نصب افزونه یا ماژول PHP استفاده کنید.

3- بررسی خطا Environment در لاراول

اگر نمی خواهید در Environment Configuration خطای جبران ناپذیری برای سیستم لاراول شما رخ دهد، باید به پیکربندی فایل های env بیش از پیش توجه کنید، زیرا اشتباهاتی مانند Database Credentials ،Program Keys یا تنظیمات نادرست در Email Driver شما را از ادامه مسیر محروم خواهد کرد. پس ابتدا مطابقت مشخصات فایل env با Environment را بررسی کرده و در حالت Production از حالت Debug بهره ببرید.

4- بررسی خطاهای رایج Debug Path و Firmware در لاراول

مسیرها و یا میان افزارهایی که به درستی پیکربندی نشوند موجب رفتارهای غیر منتظره ای در لاراول خواهند شد. بنابراین برای جلوگیری از این خطا باید List: php artisan route را در بررسی های Route و Middleware بکار ببرید. همچنین لازم است تا از ثبت و اعمال Middleware در app/Http/Kernel.php مطمئن شوید. 

5- بررسی خطا Handle package dependency در لاراول

خطاهای Dependency اغلب زمانی که می خواهید لاراول را به روز کرده و یا از بسته های جدیدی استفاده کنید رخ می دهد. برای رفع این موارد باید Composer Install را جهت نصب صحیح Dependency اجرا کرده و Composer Outdated را در بسته های قدیمی ایجاد کنید. همچنین به خاطر داشته باشید که از Composer Update برای به روز رسانی ها کمک بگیرید و مطمئن شوید که فایل Composer.json بسته های Compatible را مشخص می نماید.

6- بررسی خطا Session و Cache در لاراول

چنانچه با مشکلاتی مانند از دست دادن داده های جلسه یا خرابی حافظه پنهان رو به رو شدید، قطعاً ایراد از خطایی مانند Session و Cache است. پس برای مقابله با این نوع خطاها می توانید به بررسی تنظیمات درایور حافظه پنهان در فایل env، تنظیمات زمان پایان Session در config/session.php، پاک کردن منظم حافظه پنهان و داده های Session بپردازید.

7- بررسی خطا فرانت اند در لاراول

خطاهای فرانت اند در لاراول که به اصطلاح Laravel White نیز نامیده می شوند می تواند ناشی از مواردی مانند asset Compilation crashes (خرابی کامپایل سازی) و Versioning (نسخه سازی) باشد که برای عدم مشاهده این ایرادات باید مطمئن شوید که از نسخه های سازگار در Laravel ،Composer ،Node.js و NPM استفاده می کنید. 

8- بررسی خطا Method Not Allowed Http Exception در لاراول

جمله معروف The method is not allowed توانایی کلافه کردن تمام توسعه دهندگان لاراول را دارد! اما توصیه ما این است که دستپاچه نشوید و با مراجعه web.php یا api.php در قسمتی که route ها نوشته شده است، بررسی کنید که آیا مسیر URL از نوع دیگر HTTP به جای روش مورد نظر شما استفاده می‌کند یا خیر؟

9- بررسی خطا مجوز فایل برای ذخیره سازی در لاراول

زمانی که از لاراول برای توسعه استفاده می کنید، به طور معمول گزارش های خطا در دایرکتوری به صورت فایل ذخیره‌سازی می شود. به همین دلیل باید با کمک دستور زیر به Super User مجوزی جهت دایرکتوری ذخیره سازی داده شود:


پس اگر برای Bootstrap اغلب این گزارش را دریافت می کنید، به هر دو مورد از این دایرکتوری ها Write Access اضافه کنید:

10- بررسی خطا ReflectionException در لاراول

در حالی که به Class اشاره کنید اما آن Class در آن مکان وجود خارجی نداشته باشد، راه فراری از این خطا در لاراول نخواهید داشت! پس ابتدا در Web.php یک مسیر یا URI تعریف کرده و به Controller خاصی اشاره کنید، زیرا ممکن است مسیر اشتباه بوده و یا خود کنترلر ایجاد نشده باشد.

سخن آخر

اگز تاکنون با خطاهای زیادی در لاراول دست و پنجه نرم می کردید و با مطالعه این عنوان تعدادی از آن ها را با موفقیت حل کردید، فراموش نکنید که حفظ امنیت در درجه اول اهمیت قرار دارد و شما باید همواره برنامه های موجود در Laravel را به روز کرده و توکن هایی مانند CSRF را در forms ایجاد کنید تا از خطرات امنیتی احتمالی در امان بمانید. از همراهی شما در این راهنما بسیار ممنونیم و امیدواریم در راستا رفع عیب های رایج لاراول سیستم شما سبب برداشتن قدم های مفیدی شده باشیم.