chore(deps-dev): bump larastan/larastan from 2.9.8 to 3.9.3

[dependabot]

Bumps larastan/larastan from 2.9.8 to 3.9.3.

Release notes

Sourced from larastan/larastan's releases.

3.9.3

What's Changed

• feat: allow Laravel 13 by @​canvural in larastan/larastan#2446
• Improve config type inference to respect @​return docblocks by @​haratake22 in larastan/larastan#2445

New Contributors

• @​haratake22 made their first contribution in larastan/larastan#2445

Full Changelog: larastan/larastan@v3.9.2...v3.9.3

3.9.2

What's Changed

Added

• Improve type inference for MySQL ENUM types in squashed migrations by @​ngmy in larastan/larastan#2434

Fixed

• fix: model property type has template type larastan/larastan@0ac2cfa

New Contributors

• @​ngmy made their first contribution in larastan/larastan#2434

Full Changelog: larastan/larastan@v3.9.1...v3.9.2

3.9.1

What's Changed

Fixed

• [3.x] Update PendingRequest stubs by @​ramonrietdijk in larastan/larastan#2432

Full Changelog: larastan/larastan@v3.9.0...v3.9.1

3.9.0

What's Changed

Added

• feat: Add stubs for Cache facade by @​melvinversluijs in larastan/larastan#2420
• feat: Migration caching (enableMigrationCache option, disabled by default) in larastan/larastan@9b35634d and larastan/larastan@82c1889 Read more about it here
• feat: parseModelCastsMethod option for better cast inference in larastan/larastan@afd59445 Read more about it here:
• feat: Styled bootstrap error reporting with stack traces in larastan/larastan@1756b49a

Fixed

• [3.x] fix: nullability detection for TEXT and some other column types by @​hivokas in larastan/larastan#2422
• fix: groupBy stub in larastan/larastan@7d52136f
• fix: Primary key type inference for models using HasUuids and HasUlids (#2188) in larastan/larastan@4894e254

New Contributors

• @​melvinversluijs made their first contribution in larastan/larastan#2420
• @​hivokas made their first contribution in larastan/larastan#2422

... (truncated)

Upgrade guide

Sourced from larastan/larastan's upgrade guide.

Upgrade Guide

Upgrading to 3.0 from 2.x

This is a new major release with lots of breaking changes.

Please first read PHPStan's 2.0 upgrade guide here carefully.

Correct return types for model relation methods

Likelihood Of Impact: High

Normally PHPStan warns the users when a return type of method does not provide its generic types. For example, the following code will produce a PHPStan error:

class User extends Model
{
    public function posts(): HasMany
    {
        return $this->hasMany(Post::class);
    }
}
// Method User::posts() return type with generic class HasMany does not specify its types: TRelatedModel, TDeclaringModel

In the previous versions of Larastan, in this case Larastan would parse the model file and read the method body to understand the generic types of the relation. But this approach is slow (because it requires parsing the file) and the maintenance of this feature is hard. So in this version, Larastan will not parse the method body to understand the generic types of the relation. Instead, you need to provide the correct generic types in the return type of the relation method. Here is how you can fix the above example:

class User extends Model
{
    /**
     * @return HasMany<Post, $this>
     */
    public function posts(): HasMany
    {
        return $this->hasMany(Post::class);
    }
}

Manually adding these annotations can be tedious. To help with this, we've created a Rector rule that can automatically add them for you! You can use this rule to automatically add the correct generic annotations. It detects your Laravel version and adds the appropriate generic types accordingly.

If you're not currently using Rector, or can't use it due to dependency conflicts, don't worry! We've also prepared a simple script that can run Rector for you without requiring a full installation.

First install cpx:

composer global require cpx/cpx

Then download this script from the gist and run with:

... (truncated)

Commits

• 64a52bc feat: improve config type inference to respect return docblocks (#2445)
• 04bb863 feat: allow Laravel 13 (#2446)
• bddd5bb fix: check for more traits
• 438ddc0 fix build temporarily
• c4bcf4e fix: add generic types
• 2e9ed29 feat: improve type inference for MySQL ENUM types in squashed migrations (#...
• 0ac2cfa fix: model property type has template type
• 4b92d96 [3.x] Update PendingRequest stubs (#2432)
• 82c1889 feat: disable migration cache by default
• d0f8c1c docs: add docs for new features
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)