[12.x] Improve typehints for Http classes

[cosmastech]

I didn't quite get everything here, but I made some updates to improve typehints and static analysis.

[timacdonald]

I don't think we should be introducing phpstan specific types or more generally try to optimize for PHPStan or other singular tool. Optimizing for a narrow scope like that will lead to detrimental impacts on the wider developer experience outside of phpstan analyze.

We should be testing more exotic changes like these changes against PHPStorm, VSCode, Intelephense language server, Phpactor language server, Psalm, etc.

[cosmastech]

I don't think we should be introducing phpstan specific types or more generally try to optimize for PHPStan or other singular tool. Optimizing for a narrow scope like that will lead to detrimental impacts on the wider developer experience outside of phpstan analyze.

We should be testing more exotic changes like these changes against PHPStorm, VSCode, Intelephense language server, Phpactor language server, Psalm, etc.

I chose this because it feels a lot cleaner than just duplicating the array shapes/closure params again and again. Also, the relationship of the parent method to child methods means that it's very easy for someone to update one but not the others, which is eliminated by this local type alias.

But I can see your point. I believe there's already been at least one PR merged that has them (I was the offender on that one as well). Will be interesting to see if there are any issues that arise from that.

I can assure you that they work fine in the latest version of PHPStorm. As for the others, which I do not use:

• Intelephense appears to have some support for phpstan-type. I grepped through intelephense.js and it's contained there, but it's minified code so 🤷
• It does look like Psalm is designed to handle phpstan-type
• as well as phpactor.

Is there any kind of consensus on what PHPDoc declarations are broadly compatible? If there were somewhere that defined the standards for Laravel typehints, then I think contributors could improve the codebase with confidence. I hope that there's a path forward, because static analysis is a boon to our codebase. Having vendor code without precise types slows down development and introduces bugs that could've been caught.