Bump larastan/larastan from 2.9.12 to 3.10.0

[dependabot]

Bumps larastan/larastan from 2.9.12 to 3.10.0.

Release notes

Sourced from larastan/larastan's releases.

3.10.0

What's Changed

Added

• PHPStan 2.2.0 compatibility
• Update codestyle check to latest version by @​jnoordsij in larastan/larastan#2484
• Add export-ignore for assets directory in .gitattributes by @​joke2k in larastan/larastan#2490
• Add type narrowing for where method on collections by @​jnoordsij in larastan/larastan#2483

Fixed

• fix: invalid parameter name by @​calebdw in larastan/larastan#2488
• Fix failing tests on Windows by @​jnoordsij in larastan/larastan#2486

Internal

• Allow PHPUnit v13 by @​jnoordsij in larastan/larastan#2485
• docs: update coding style guidelines in CONTRIBUTING.md by @​haratake22 in larastan/larastan#2447

New Contributors

• @​joke2k made their first contribution in larastan/larastan#2490

Full Changelog: larastan/larastan@v3.9.6...v3.10.0

3.9.6

What's Changed

Added

• Improve blade view parsing for NoMissingTranslationsRule by @​FeBe95 in larastan/larastan#2476

Fixed

• fix: undefined array key internal error when view path has trailing slash by @​FeBe95 in larastan/larastan#2478

Full Changelog: larastan/larastan@v3.9.5...v3.9.6

3.9.5

What's changed?

Fixed

• fix: fix infinite loop when Redis extension is missing

Full Changelog: larastan/larastan@v3.9.4...v3.9.5

3.9.4

What's Changed

Changed

• refactor: create new extensions out of old pipeline based approach by @​canvural in larastan/larastan#2448

... (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

• 2970f83 feat: add type narrowing for where method on collections (#2483)
• 936f20b fix failing tests on Windows (#2486)
• c856507 Add export-ignore for assets directory in .gitattributes (#2490)
• 9b014b5 chore: bump phpstan memory limit
• d58d982 chore: run SA on Laravel 13 too
• 7c4347c docs: use correct coding standard name
• 1e243f1 docs: update coding style guidelines in CONTRIBUTING.md (#2447)
• 45a4414 chore: update codestyle check to latest version (#2484)
• 0e774c5 chore: allow PHPUnit v13 (#2485)
• 9ef66e1 fix: invalid parameter name (#2488)
• Additional commits viewable in compare view