Laravel? ???? ? ?????? ???? ?? ?? ??? ?? PHPStan? ???? ?? Laravel?? ?????? ? ??? ??? ???? ?????. 11.x.

PHPStan? ???? ?? Laravel? ??? ?? ./vendor/bin/phpstan? ?? ???? ?? ??? ?????.

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------

??? ??? ?????? Laravel 11?? HasFactory ???? ?? ??? ?? ?? ? ??? @template ??? ?? PHPDoc? ????. ?? ??????? ???? ?????? ?? ???? ???? ????.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}

????? ??? phpstan.neon ??? ?? ?? ?? ???? ? ?? ??? ??? ? ????.

parameters:
    ignoreErrors:
        -
            identifier: missingType.generics

??? ???? ??? ???? ??? ??? ??? ???!

????? ??????

??????? ???? ?? ??? ??? ??? ? ?? ??? ??? ? ?? ??? ?????. ? ??? ??? ?? ??? ??? ???? ?? ?? ?? ??? ?? ???? ??? ???? ?? ?? ?? ???? ????? ??? ???? ??? ? ?? ??? ???? ?? ??? ??? ? ????.

Laravel 10?? IlluminateDatabaseConcernsBuildsQueries::first ???? ???? IlluminateDatabaseEloquentBuilder ?? null? ?? ?? ???? ???? ????? ?? ??? Model? ????? ??? ? ????.

/**
 * Execute the query and get the first result.
 *
 * @param  array|string  $columns
 * @return \Illuminate\Database\Eloquent\Model|object|static|null
 */
public function first($columns = ['*'])
{
    return $this->take(1)->get($columns)->first();
}

??? ??

???? PHP?? ?????? ???? ????. ?? ????? PHPDocs ?? @template, @template-covariant, @template-contravariant, @extends, @implements ? @use.

?? ??? ??? ?? ????? ???? ?????. PHPDocs??? @template ??? ??? ???. ?? ???? ??? ?? ??? ??? ???? ?? ? ???? ? ? ????. of ???? ???? ?? ???? ?? ??? ? ?? ??? ???? ??? ?? ????. ?? ??? ?? ????
?? ???.

<?php

namespace Illuminate\Database\Eloquent;

/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 *
 */
class Builder implements BuilderContract
{
}

PHP ???? ??

?? ??

?? ??? ?? ??? ???? ?? ????? ????. ?? ?? ???? ??? ?? ???? ???? ??? ? ????.

IlluminateSupportValidatedInput::enum ???? ?? ?????.

• ?? ???? TEnum? ?????.

• $enumClass ????? ?? ?? class-string?? ??? ?? ???? TEnum? ?????.

• ?? ??? TEnum ?? null? ?? ????.
  

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------

$request→validated()→enum('status', OrderStatus::class)? ???? PHPStan? OrderStatus ?? ?? null? ???? ?? ?? ???!

?? ???

?? ???? ???? ?? ???? ????? ?? ??? ???? ??? ? ?? ???? ?? ? ????. ?? ??? ?? ?? ???? ???? ??? ? ???, ??? ???? ?????? ? ??? ? ????.

Laravel ?? ??? ?? ?? IlluminateDatabaseEloquentBuilder ??????.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}

?? ???? TModel? IlluminateDatabaseEloquentModel? ?? ?? ???? ???? ??????. make ???? ?? ???? ??? ?? ????? ?????.

? ?? ??? ??? ?? ??? ????? ?? ??? ?? ?? ??? ?? ?????. ?? ???? TModel ??? ???? ???

parameters:
    ignoreErrors:
        -
            identifier: missingType.generics

?? info: BelongsTo ? HasOne? ?? IlluminateDatabaseEloquentRelations ??????? ?? Eloquent ?? ???? ?? ?? ??????.

?? ?????

?? ?????? ?? ??? ????. IlluminateContractsSupportArrayable? ?? ?????? ????

/**
 * Execute the query and get the first result.
 *
 * @param  array|string  $columns
 * @return \Illuminate\Database\Eloquent\Model|object|static|null
 */
public function first($columns = ['*'])
{
    return $this->take(1)->get($columns)->first();
}

?????? ?? ? ??? TKey(int ?? ???? ? ??)? TValue?? ? ?? ?? ????? ?????. ? ? ????? toArray ??? ?? ??? ???? ? ?????. ?? ??? ????.

<?php

namespace Illuminate\Database\Eloquent;

/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 *
 */
class Builder implements BuilderContract
{
}

??? ???? Arrayable ?????? ???? Tkey ??? int?, TValue? ???? ?????.

?? ??

? ??? ?? ??? ???? IlluminateDatabaseEloquentFactoriesHasFactory ??? ??????. ? ? ??? ???????:

/**
 * @template TEnum
 *
 * @param string $key
 * @param class-string<TEnum> $enumClass
 * @return TEnum|null
 */
public function enum($key, $enumClass)
{
    if ($this->isNotFilled($key) ||
        ! enum_exists($enumClass) ||
        ! method_exists($enumClass, 'tryFrom')) {
        return null;
    }
    return $enumClass::tryFrom($this->input($key));
}

HasFactory? IlluminateDatabaseEloquentFactoriesFactory? ?? ???? ???? ?? ???? TFactory? ?????. ??? ?? ??? ??? ??? ? ????

??? ??? ? TFactory ??? ???? ???. ??? HasFactory ??? use ?? PHPDocs @use:
? ??? ??? ???.

<?php

namespace Illuminate\Database\Eloquent;
/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 */
class Builder implements BuilderContract
{
    /**
     * @param  array  $attributes
     * @return TModel
     */
    public function make(array $attributes = [])
    {
        return $this->newModelInstance($attributes);
    }
}

??? ??

??? ??, ????? ??, ?? ?? ? ?? ???? ???? ??? ? ????.

???? ???? ??? ?? ??? ?? ??? ?? ????? ???? ?? @extends, @implements ? @use ??? ???? ???? ?????.

??????DatabaseConcernsBuildsQueries ?? ??? ?? ???????.

?? ???? TValue? ?????:

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------

IlluminateDatabaseEloquentBuilder ???? ? ??? ????? TModel ???? ??? ???? ???? ?????. ?? TModel ??? ???? ????? BuildsQueries ??? TValue? ???? ?? ????? ??? ??????.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}

?? ??

?????, PHP? ?? ????? ??? ??? ???? ???? ????? ???? ??? PHPStan? ?? ?? ?? ?? ? ??? ???? ???? ??? ???? ??? ??? ??? ? ????. . PHPDocs, ?????? ??? ? ?????? ???? ?? ????? ?? ???? ????? ?? ???? ??? ??? ??????? ?? ? ????. PHP? ?? ???? ?? ?? ???? ?? ??? ?? ????? ??? ????? ??? ??? ?? ?? ??? ???? ??? ???? ????. ??? ??? ???? ?? ??? ??? ?? ??? ??? ??? ???? ??? ????? ??? ?????.

? ??? Laravel 11? PHP ???? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!