انالیز و خطایابی کدها در لاراول

سلام دوستان من از این پکیج برای انالیز کدها استفاده میکنم

https://github.com/nunomaduro/larastan

اول اینو بگم که پروژه رو ران میکنم همه چی اوکی و اصلا در طول کار هیچ خطایی هم نمیده... اما بعد از نصب این پکیج و اجرا دستور انالیز کدها, دقیقا 203 خطا برام پیدا کرد بیشترخطاها هم تغریبا مثل هم هستند : (البته این کل خروجی نیست)

------ ---------------------------------------------------------------------------------------------------------------
  Line   app\Rules\Auth\UnusedPassword.php
 ------ ---------------------------------------------------------------------------------------------------------------
  19     PHPDoc tag @var has invalid value (): Unexpected token "\r\n     ", expected TOKEN_IDENTIFIER at offset 16
  27     PHPDoc tag @param has invalid value ($user): Unexpected token "$user", expected TOKEN_IDENTIFIER at offset 63
 ------ ---------------------------------------------------------------------------------------------------------------

 ------ -----------------------------------------------------------------------------------------------------------------
  Line   app\helpers.php
 ------ -----------------------------------------------------------------------------------------------------------------
  50     PHPDoc tag @param has invalid value ($folder): Unexpected token "$folder", expected TOKEN_IDENTIFIER at offset
         127
  53     Class RecursiveDirectoryIterator referenced with incorrect case: recursiveDirectoryIterator.
  54     Class RecursiveIteratorIterator referenced with incorrect case: recursiveIteratorIterator.
  57     Call to an undefined method RecursiveIteratorIterator::isDot().
  57     Call to an undefined method RecursiveIteratorIterator::isFile().
  57     Call to an undefined method RecursiveIteratorIterator::isReadable().
  99     PHPDoc tag @param has invalid value ($url): Unexpected token "$url", expected TOKEN_IDENTIFIER at offset 25
  114    PHPDoc tag @param has invalid value ($url): Unexpected token "$url", expected TOKEN_IDENTIFIER at offset 25
  129    PHPDoc tag @param has invalid value ($cancel_to): Unexpected token "$cancel_to", expected TOKEN_IDENTIFIER at
         offset 26
  129    PHPDoc tag @param has invalid value ($title): Unexpected token "$title", expected TOKEN_IDENTIFIER at offset 59
  143    PHPDoc tag @param has invalid value ($title): Unexpected token "$title", expected TOKEN_IDENTIFIER at offset 26
  156    PHPDoc tag @param has invalid value ($str): Unexpected token "$str", expected TOKEN_IDENTIFIER at offset 19
 ------ -----------------------------------------------------------------------------------------------------------------

 [ERROR] Found 203 errors

روی چندتا پروژه اوپن سورس هم این انالیز رو انجام دادم و برای اونها هم چنین خطاهایی وجود داشت حالا بنظرتون با اینکه من هم روی لوکال و هم سرور پروژه رو تست کردم و هیچ مشکلی هم نداشته, این خطا ها میتونن مشکل ساز بشن؟

حالا بنظرتون با اینکه من هم روی لوکال و هم سرور پروژه رو تست کردم و هیچ مشکلی هم نداشته, این خطا ها میتونن مشکل ساز بشن؟

خیر، این دسته از ارورها errors مشکل خاصی ایجاد نمیکنند.

چرا که با توجه به این بخشی از errorها که در سوالتون به اشتراک گذاشتید، به راحتی میشه متوجه شد که ارورهای خیلی مهمی نیستند.

به عبارت بهتر، از نظر من یک سری notice هستند که دارند از عدم استاندارد بودن کدهای شما صحبت میکنند. این عدم استاندارد بودن به معنی «غیر بهینه بودن» کدهای شما و یا الگوریتم های شما نیست، بلکه به معنی «عدم رعایت استانداردهای جهانی و ساختار کد» هست.

به عنوان مثال، این ارور error:

PHPDoc tag @param has invalid value ($title)

که داره صرفا به یک استاندارد کامنت گذاری در کد به زبان php اشاره میکنه. مثلا کد زیر رو ببینید:

/*
@params
@return
*/
public function funcName(array $param1, $param2){
     // your codes
}

همونطور که میبینید، در بالای متد بالا، من 2 تا عبارت @params و @return رو نوشتم که باید طبق یک استانداردی (لینک داکیومنتیش) پارامترهایی که این متد دریافت میکنه و خروجی که این متد برمیگردونه رو بنویسید. اگه براش هیچی ننویسید یا طبق یک الگوی غیر استاندارد بنویسید، اون ارور بالا رو دریافت میکنید توسط ابزارهای آنالیزگر کد.

پس تمام ارورهایی که با PHPDoc شروع میشن، صرفا به استاندارد سازی اشاره میکنن و از نظر فنی مشکلی ایجاد نمیکنن. فقط هدفشون اینه که کد شما رو تمیز تر کنن و بطوری که اگر پروژتون وسیع شد و برنامه نویس های دیگری هم به پروژتون اضافه شدن به راحتی بتونن کد رو بفهمن و توسعه بدن.

ولی ارور هایی مثل:

Call to an undefined method

یک مقدار نگران کننده هستند. شما یک متدی به اسم isDot() رو از کلاس RecursiveIteratorIterator به صورت استاتیک فراخوانی کردید که تعریف نشده. شایدم تعریف شده ولی use نشده اون بالای کد. که این دسته از ارورها خب یک مقدار مهم تر هستند و باید بهشون رسیدگی بشه.

ولی اگه مجموعه میگید که هم روی لوکال و هم روی سرور کدتون داره درست کار می کنه، خیلی جای نگرانی نیست و میتونید بزارید سر فرصت به اینجور ارور ها (یا از نظر من noticeها) رسیدگی کنید.