Larastan-Laravel мүмкіндіктерін қолдайтын статикалық кодты талдауға арналған PHPStan үстіндегі орауыш. Larastan пайдалану кодтың сапасын жақсартатын және қателерді түзетуге кететін шығындарды азайтатын кодтың ықтимал қателерін әзірлеудің бастапқы кезеңдерінде анықтауға мүмкіндік береді. Бұл нұсқаулықта біз Laravel қолданбасының сапасын 9-деңгейге көтеру үшін Larastan -. қалай орнатуға, конфигурациялауға және пайдалануға болатынын қарастырамыз.

Бірінші қадам-сіздің жобаңызға Larastan орнату. Бұл Composer көмегімен жасалады:

composer require larastan/larastan:^2.0 --dev

Бұл қадам larastan-ваш сіздің жобаңызға тәуелділік ретінде қосады. Осыдан кейін PHPStan конфигурация файлын жасау керек.

Жобаңыздың түбірінде phpstan файлын жасаңыз.neon. Бұл файлда PHPStan және Larastan үшін конфигурация болады:

includes:
    - vendor/larastan/larastan/extension.neon

parameters:
    paths:
        - app/
    level: 0

Бұл файлда біз larastan кеңейтімін қолданатынымызды және кодты тексерудің бастапқы деңгейін орнататынымызды көрсетеміз.

Енді біз бірінші кодты талдауды бастай аламыз:

./vendor/bin/phpstan analyse

Бұл талдау сіздің кодыңыздағы қателер мен ескертулерді көрсетеді. Бастапқы деңгейде (0-деңгей) проблемалардың ең аз саны анықталады. Сіздің міндетіңіз-деңгейге көтерілмес бұрын анықталған барлық қателіктерді түзету.

Larastan және PHPStan талдау деңгейлерін 0-ден 9-ға дейін қолдайды. Әр деңгей кодты тексерудің қатаң ережелерін қамтиды. Ағымдағы деңгейдегі барлық қателерді түзеткеннен кейін конфигурация файлындағы деңгейді көтеруге болады:

peopcopy codparameters:
    level: 1

Деңгей өзгергеннен кейін талдауды қайта бастаңыз және анықталған қателерді түзетіңіз. Бұл процесті 9-деңгейге жеткенше қайталаңыз.

Негізгі тексеруден басқа, Larastan код сапасын жақсарту үшін қосымша мүмкіндіктер ұсынады:

1. Түрлерді талдау: Larastan деректер түрлерін тексереді, бұл түрлерді дұрыс пайдаланбауға байланысты қателерді болдырмауға көмектеседі.
2. Анотацияны қолдау: Larastan сіздің кодыңыздағы @var, @param, @return сияқты анотацияларды түсінеді және оларды түрлердің сәйкестігін тексеру үшін пайдаланады.
3. Эталондық Интеграция: Larastan сіздің тесттеріңізбен біріктірілуі мүмкін, бұл тесттер орындалмай тұрып қателерді анықтауға мүмкіндік береді.

Larastan кодты жақсартуға қалай көмектесетіні туралы бірнеше мысалды қарастырыңыз.

function add(int $a, int $b): int {
    return $a + $b;
}

echo add(1, '2');

Бұл мысалда функция int түрінің екі параметрін күтеді, бірақ екінші параметр жол ретінде беріледі. Larastan бұл қатені анықтап, ЕСКЕРТЕДІ.

/**
 * @param int $a
 * @param int $b
 * @return int
 */
function add($a, $b) {
    return $a + $b;
}

Егер сіз функциядағы параметрлердің түрлерін қосуды ұмытып қалсаңыз, Larastan анотацияларды тексереді және түрлердің сәйкессіздігін көрсетеді.

Larastan-вашем Laravel - жобаңызда пайдалану кодтың сапасын айтарлықтай жақсартуға мүмкіндік береді, қателерді әзірлеудің бастапқы кезеңдерінде анықтайды. Тексеру деңгейін 0-ден 9-ға дейін дәйекті түрде көтеру кодты сенімді және қауіпсіз етуге көмектеседі.