如何告诉 PhpStorm function 参数是文件路径

Question

In PhpStorm (and other JetBrains IDE), is it possible to make function attributes as file / resource path?

Eg in this function:

function mix($file): string
{
  // check mix maninfest for $file and return path from mix manifest
  return $fire_path_with_cachebuster;
}

I'd like PHP to suggest files in the project as I define $file attribute when calling mix function.

Answer 1

Only manually for the moment, when calling that function. And it's a temp injection (for a session) so it's not convenient:

mix('')

• Place caret inside the string parameter
• Use Alt + Enter (or via light bulb icon) to bring the Quick Fix / Intentions menu (on some Keymaps it might be different one)
• Use "Inject language or reference" option
  
• Then choose "File Reference" entry there (just start typing to filter the list).

The result:

---

Hopefully they will implement the following tickets for a permanent solution:

• Using #[Language] PHP attribute at the function declaration : https://youtrack.jetbrains.com/issue/WI-56996
• Or in-place via PHPDoc-like comment (before the parameter when calling that function ): https://youtrack.jetbrains.com/issue/WI-20028

Watch those tickets (star/vote/comment) to get notified on any progress (and hopefully speed it up by bringing dev's attention).

Answer 2

Like LazyOne stated, there is currently no way to declare a parameter as being a file reference.

However, you can get a more permanent File Reference "injection" by [mis]using __DIR__ .

PhpStorm considers a string mixed with the __DIR__ constant to be a file path:

It isn't perfect as it depends on what directory you are currently located in. If you only want the filename passed to your method, you can wrap the string in basename , or handle that from within your method.

echo mix(basename(__DIR__ . '/slack_bot.php'));