Probe view() calls for Blade variables

[CicerBro]

Can't remember if this was always the case with PHPantom or not. But when working in Blade files, basically every passed in variable is said to be undefined right now.

Example controller:

return view('someviewname')->with('results', $results);

In view:

@foreach ($results as $r)

Will show a Undefined variable '$results' in the IDE.

[AJenbo]

You should declare the at the top of the template, it's similar to how it can't do much with a function if you do not add types to it.

Se an example here:
https://github.com/bladestan/bladestan/blob/ea8922cc593d3eea575a8bddf0de21d8c4c6fa3a/README.md#declare-template-signatures

@php
/**
 * @var mixed $results
 */
@endphp

The next version (you can already use it via dev-rewrite as the version) of Bladestan also includes a command you can run to add them automatically:
https://github.com/bladestan/bladestan/blob/ea8922cc593d3eea575a8bddf0de21d8c4c6fa3a/README.md#generate-signatures

We could add probing where it scans for variables passed at call sites, but it's both slow and error prone so I strongly recommend adding a signature to the templates

[CicerBro]

Hmm ok ok. Don't really want to "pollute" all blade files with docblocks :-)

Is there a way for PHPStan to ignore Blade files instead?

[AJenbo]

I don't think you should see it as polluting them it's simply documenting there expected input, but ok. Yes you can simply remove the resource folder from paths it scans in phpstan.neon

[CicerBro]

I have that actually. I thought this was a PHPantom error and not something surfaced from PHPStan.

    excludePaths:
        - vendor/*
        - resources/views/*

[AJenbo]

You should have said so :D

Is there a way for PHPStan to ignore Blade files instead?

No, there is no way to turn it off for PHPantom, it legitimately cannot find these variables anywhere since they are not defined. Other IDEs like PhpStorm would also benefit from having the template variables explicitly declared.

If you hint the you will get compleation etc in the blade files as well.

[CicerBro]

Sorry, PHPStan/PHPantom. Easy typo hehe. I meant for PHPantom to ignore Blade.

I'll have a second look at type hinting. Working with PHP can be such a pain in the arse at times but pretty happy with PHPantom so far compared to my old setup with Intelephense etc. 👍🏻

[AJenbo]

Infering it from call site is BL12 in the todo: https://github.com/PHPantom-dev/phpantom_lsp/blob/main/docs/todo/blade.md#bl12-call-site-variable-inference-late-addition